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Preface 


The  selection  of  an  instream  flow  requirement  for  water  resource  management  often  requires  the  review  of  how  the 
physical  habitat  changes  through  time.  This  review  is  referred  to  as  ‘Time  Series  Analysis.** 

The  Time  Series  Library  (TSLIB)  is  a  group  of  programs  to  enter,  transform,  analyze,  and  display  time  series  data  for 
use  in  stream  habitat  assessment.  A  time  series  may  be  defined  as  a  sequence  of  data  recorded  or  calculated  over  time. 
Examples  might  be  historical  monthly  flow,  predicted  monthly  weighted  usable  area,  daily  electrical  power  generation, 
annual  irrigation  diversion,  and  so  forth.  The  time  series  can  be  analyzed,  both  descriptively  and  analytically,  to  understand 
the  importance  of  the  variation  in  the  events  over  time.  This  is  especially  useful  in  the  development  of  instream  flow  needs 
based  on  habitat  availability. 

The  TSLIB  group  of  programs  assumes  that  you  have  an  adequate  study  plan  to  guide  you  in  your  analysis.  You  need  to 
already  have  knowledge  about  such  things  as  time  period  and  time  step,  species  and  life  stages  to  consider,  and  appropriate 
comparisons  or  statistics  to  be  produced  and  displayed  or  tabulated.  Knowing  your  destination,  you  must  first  evaluate 
whether  TSLIB  can  get  you  there.  Remember,  data  are  not  answers. 

This  publication  is  a  reference  manual  to  TSLIB  and  is  intended  to  be  a  guide  to  the  process  of  using  the  various  programs 
in  TSLIB.  This  manual  is  essentially  limited  to  the  hands-on  use  of  the  various  programs. 

ATSLIB  user  interface  program  (called  RTSM)  has  been  developed  to  provide  an  integrated  working  environment  where 
the  user  has  a  brief  on-line  description  of  each  TSLIB  program  with  the  capability  to  run  the  TSLIB  program  while  in  the 
user  interface.  For  information  on  the  RTSM  program,  refer  to  Appendix  F. 

Before  applying  the  computer  models  described  herein,  it  is  recommended  that  the  user  enroll  in  the  short  course  “Problem 
Solving  with  the  Instream  How  Incremental  Methodology  (IFIM).**  This  course  is  offered  by  the  Aquatic  Systems  Branch 
of  the  National  Ecology  Research  Center.  For  more  information  about  the  TSLIB  software,  refer  to  the  Memorandum  of 
Understanding. 

Chapter  1  provides  a  brief  introduction  to  the  Instream  How  Incremental  Methodology  and  TSLIB.  Other  chapters  in 
this  manual  provide  information  on  the  different  aspects  of  using  the  models.  The  information  contained  in  the  other  chapters 
includes  (2)  acquisition,  entry,  manipulation,  and  listing  of  streamflow  data;  (3)  entry,  manipulation,  and  listing  of  the 
habitat-versus-streamflow  function;  (4)  transferring  streamflow  data;  (5)  water  resource  systems  analysis;  (6)  generation 
and  analysis  of  daily  streamflow  and  habitat  values;  (7)  generation  of  the  time  series  of  monthly  habitats;  (8)  manipulation, 
analysis,  and  display  of  monthly  time  series  data;  and  (9)  generation,  analysis,  and  display  of  annual  time  series  data. 

Each  section  includes  documentation  for  the  programs  therein  with  at  least  one  page  of  information  for  each  program, 
including  a  program  description,  instructions  for  running  the  program,  and  sample  output. 

The  Appendixes  contain  the  following:  (A)  sample  file  formats;  (B)  descriptions  of  default  filenames;  (Q  alphabetical 
summary  of  batch-procedure  files;  (D)  installing  and  running  TSLIB  on  a  microcomputer,  (E)  running  TSLIB  on  a  CDC 
Cyber  computer,  (F)  using  the  TSLIB  user  interface  program  (RTSM);  and  (G)  running  WATSTORE  on  the  USGS  Amdahl 
mainframe  computer. 

The  number  for  this  version  of  TSLIB — ^Version  n — ^is  somewhat  arbitrary,  as  the  TSLIB  programs  were  collected  into 
a  library  some  time  ago;  but  operators  tended  to  use  and  manage  them  as  individual  programs.  Therefore,  we  will  consider 
the  group  of  programs  from  the  past  that  were  only  on  the  CDC  Cyber  computer  as  Version  0;  the  programs  from  the  past 
that  were  on  both  the  Cyber  and  the  IBM-compatible  microcomputer  as  Version  I;  and  the  programs  contained  in  this 
reference  manual  as  Version  11. 

To  obtain  magnetic  tapes  or  floppy  disks  of  the  TSLIB  programs  contact 

TGS  Technology 

FWS-NERC  Operations 

RO.  Box  9076 

Fort  Collins,  Colorado  80525 

(303)  226-9413 
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For  technical  assistance  with  TSLIB  programs,  contact: 

Support  Services  Branch 
National  Ecology  Research  Center 
U.S.  Fidi  and  Wildlife  Service 
4512  McMurray  Avenue 
Fort  Collins,  Colorado  80525 
(303)  226-9100 


As  errors  are  corrected,  enhancements  made,  or  new  programs  added  to  TSLIB,  new  versicms  will  be  released. 
Tnpmmfintal  changes  may  be  available  on  the  National  Ecology  Research  Center  computer  bulletin  board.  Call 
(303)  226-9365  with  no  parity,  8  data  bits,  and  1  stop  bit  to  download  programs  (See  Section  9  in  the  Memorandum  of 
Understanding). 


Memorandum  of  Understanding 
National  Ecology  Research  Center 


Received  from  the 
U.S.  Department  of  the  Interior 
Fish  and  Wildlife  Service 


This  agreement,  in  compliance  with  the  Freedom  of  Information  Act  (43  CFR,  Part  2),  serves  as  evidence  of  the  mutual 
tmderstanding  governing  the  distribution  and  subsequent  use  of  computer  software  developed  by  the  National  Ecology 
Research  Center  (NERC).  The  imdersigned,  as  an  independent  individual  or  as  the  responsible  official  of  the  firm, 
instimtion,  association,  government  agency,  or  other  such  group,  agrees  that  all  its  members,  affiliates,  and  employees 
shall  abide  by  the  conditions  listed  below.  (Conditions  1  and  2  specifically  apply  to  nongovernmental  entities,  including 
corporations,  private  individuals,  and  profit-making  associations.) 

1.  The  computer  programs  are  furnished  by  the  NERC  and  are  accepted  and  used  by  the  recipient  individual  or  group 
entity  with  the  express  understanding  that  the  United  States  Government  makes  no  warranties,  expressed  or  implied, 
concerning  the  accuracy,  completeness,  reliability,  usability,  or  suitability  for  any  particular  purpose  of  the  informa¬ 
tion  or  data  contained  in  the  programs,  or  furnished  in  connection  therewith,  and  the  United  States  shall  be  under  no 
liability  whatsoever  to  any  such  individual  or  group  by  reason  of  use  thereof. 

2.  There  shall  be  no  operational  support  (including  technical  assistance)  of  software  or  documentation  transferred  from 
the  NERC  to  a  government  entity  unless  specifically  funded  through  a  current  fiscal  year  agreement,  such  as  Project 
Study  Plan,  Interagency  or  Cooperative  Agreement,  or  other  appropriate  arrangement.  The  NERC  cannot  provide 
operational  support  to  nongovernmental  entities. 

3.  NERC  programs  were  developed  by  the  Federal  Government  with  public  funds.  Therefore,  it  is  illegal  to  assert  any 
proprietary  rights  thereto  or  to  represent  the  programs  to  anyone  as  other  than  Government  programs.  The  programs 
should  be  used  only  in  the  public  interest  and/or  the  advancement  of  science.  The  recipient  shall  not  imply  proprietaty 
possession  of  these  programs  in  seeking  clients  for  their  application  in  either  the  public  or  private  sectors.  The  recipient 
may  charge  clients  for  the  ordinary  cost  of  applying  these  programs. 

4.  The  recipient  also  understands  that  the  current  programs  and  all  documents  related  thereto  may  be  Hisp^ntinnpft  from 
further  support  or  maintenance  by  the  NERC  at  any  time.  When  the  NERC  supports  or  maintains  an  updated  version 
of  any  program  and/or  related  document,  the  recipient  may  request  the  newest  version.  The  NERC  will  notify  recorded 
users  of  updates  and  new  products  at  the  NERC’s  initiative,  but  such  notifications  are  subject  to  budget  and  policy 
constraints.  Recipients  are  not  afforded  any  sort  of  subscription  service. 

5.  All  recipient-modified  program  source  code  and  documentation  should  acknowledge  the  appropriate  source  of  the 
parent  computer  programs  and  algorithms.  The  recipient  shall  not  represent  modified  NERC  programs  or  documen¬ 
tation  or  outputs  from  the  programs  as  original  NERC  products.  Reference  shall  be  made  to  the  NERC  software,  as 
modified  by  the  recipient.  Recipients  who  modify  or  enhance  NERC  software  shall  notify  the  NERC  of  the  programs 
and/or  algorithms  modified  and  shall  provide  the  NERC  with  copies  of  those  changes.  The  NERC  reserves  the  right 
to  provide  future  revisions  and  enhancements  of  programs  provided  under  this  imderstanding.  Recipients  are 
encouraged  not  to  assert  proprietary  rights  to  any  enhancements  because  work  at  the  NERC  may  duplicate  or  surpass 
their  efforts. 

6.  If  the  source  code  or  documentation  of  NERC  programs  is  transferred  to  a  third  party,  a  copy  of  this  Memorandum 
of  Understanding  shall  accompany  those  products,  and  the  NERC  shall  be  notified  of  the  transfer.  This  notification 
shall  include  the  name,  address,  and  telephone  number  of  the  third  party.  Aimouncements  of  updates  and  releases  of 
the  NERC  programs  may  be  provided,  at  NERC’s  initiative,  to  all  recorded  users  of  NERC  software.  For  purposes 
of  this  memorandum,  “third  party”  refers  to  any  physical  host  computer  facility  other  than  the  one  at  the  original 
recipient’s  location. 

7.  All  documents  and  reports  conveying  information  obtained  as  a  result  of  the  use  of  original  NERC  programs,  by 
either  recipient  or  third  party  users,  shall  acknowledge  their  origin  as  being  the  National  Ecology  Research  Center, 


Fish  and  Wildlife  Service,  United  States  Department  of  the  Interior.  If  the  programs  have  been  modified  and/or  are 
no  longer  supported  or  maintained  by  the  NERC,  this  status  shall  be  stated  in  the  acknowledgment.  The  recipient 
agrees  to  send  a  copy  of  each  report  or  publication  in  which  the  software  was  used  to  the  National  Ecology  Research 
Center. 

8.  The  recipient  understands  that  the  acknowledgement  of  the  National  Ecology  Research  Center,  U.S.  Fish  and  Wildlife 
Service,  shall  not  explicitly  or  implicitly  be  used  to  support  the  specific  analysis,  interpretations,  or  other  findings  of 
an  application  or  study  utilizing  these  computer  programs. 

9.  When  the  recipient  has  signed  and  returned  this  document  to  the  National  Ecology  Research  Center,  the  recipient 
will  be  provided  a  telephone  number  (and  password — ^if  needed)  for  access  to  the  electronic  Bulletin  Board  system 
used  to  convey  information  concerning  the  status  of  this  software. 


NERC  Representative 


Date  Recipient  Signature 


Date 


Please  Print 

Name: 

Company: 

Address: 


Telephone  Number: _ 

Software  Package  received: 
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Chapter  1. 

Introduction 


Time  Series  Analysis 

The  premise  of  time  series  analysis  is  that  the  instream 
physical  habitat  at  a  given  time  and  place  can  be  calculated 
as  a  function  of  the  streamflow  using  the  equation 
HA(r)-PH(Q(f)) 


where 

PH(  )  is  the  physical  habitat-versus-streamflow  func¬ 
tion  for  a  given  life  stage  and  species  of 
aquatic  organism  or  river  activity; 

Q(r)is  the  streamflow  at  time  t;  and 
HA(r)  is  the  habitat  area  for  time  t. 

The  physical  habitat  represents  the  space  in  a  river  that  can 
be  used  as  habitat  by  a  given  species  and  life  stage  of  fish. 
The  assumptions  and  calculation  procedures  used  to  deter¬ 
mine  the  physical  habitat  are  described  in  Stalnaker  (1979). 
The  Time  Series  LIBraiy  (TSLIB)  of  programs  has  been 
developed  to  analyze  the  pattern  of  time-varying  events. 

The  TSLIB  system  can  be  considered  a  decision  support 
system  with  the  decision  being  quantification  of  an  in- 
stream  flow  need,  an  instream  flow  water  right,  or  a 
minimum  flow  requirement  for  operation  of  a  water  re¬ 
source  project.  The  general  concept  of  a  decision  support 
system  using  TSLIB  is  shown  in  Fig.  1.1;  the  objective  is 
to  choose  between  water  resource  management  alterna¬ 
tives  or  to  modify  the  operation  of  an  existing  water 
resource  system. 

A  system  has  been  developed  to  simulate  the  physical 
habitat  as  a  function  of  streamflow:  the  Physical  HABitat 
SIMulation  system  (PHABSIM),  described  in  Milhous 
et  al.  (1989).  If  PHABSIM  is  used  to  generate  the  habitat- 
versus-streamflow  function,  then  the  physical  habitat  is 
called  Weighted  Usable  Area  and  PH(r)  =  WUA(  ),  where 
WUA(  )  is  the  weighted  usable  area  versus  streamflow 
function. 

Time  series  requires  two  types  of  data — streamflow  data 
and  the  habitat-versus-streamflow  function.  The  use  of  the 
TSLIB  programs  does  not  require  that  PHABSIM  be  used 
to  generate  PH(  ),  but  it  does  require  that  the  PH(  ) 
function  exist  and  be  credible.  An  example  of  the  PH(  ) 
function  (generated  using  PHABSIM)  is  shown  in  Fig.  1 .2. 

A  streamflow  time  series  has  elements  that  are  the  vol¬ 
ume  of  water  flowing  past  a  point  divided  by  the  time  in 
the  period.  For  example,  the  White  River  at  Petersburg, 


Indiana,  had  a  flow  of  3,905  ft^/s  during  one  month 
(1.0460  X  lOlO  ft3  in  2,678,400  s)  or  239,700  acre-ft  per 
month.  In  this  manual,  the  average  in  cubic  feet  per  second 
over  the  period  is  usually  used. 

The  streamflow  time  series  is  used  to  develop  a  physical 
habitat  time  series.  The  results  of  using  the  habitat  relation 
for  adult  rainbow  trout  and  monthly  streamflow  for  the 
Snoqualmie  River  are  illustrated  in  Fig.  1 .3 .  A  comparison 
of  the  streamflow  time  series  to  the  habitat  time  series 
proves  the  following  two  principles,  which  tend  to  be  true 
in  many  regions  and  for  many  species: 

•  The  physical  habitat  time  series  is  less  variable  than 
the  streamflow  time  series;  and 

•  There  are  some  streamflows  where  a  moderate  reduc¬ 
tion  in  streamflow  during  some  times  of  the  year  can 
result  in  a  large  reduction  in  physical  habitat  (e.g., 
compare  August  1973  to  August  1972). 

Annual  physical  habitat  values  can  be  obtained  from  the 
monthly  habitat  values.  The  annual  values  for  adult  rain¬ 
bow  trout  in  the  Snoqualmie  River  are  illustrated  in 
Fig.  1.4.  In  this  case,  the  annual  value  for  adult  physical 
habitat  in  Fig.  1.4  is  the  minimum  monthly  habitat  avail¬ 
able  during  the  water  year. 

The  concept  advanced  by  Milhous  (1983)  is  that  a  physi¬ 
cal  habitat-versus-streamflow  function  can  be  used  as  a 
surrogate  for  an  economic  production  function.  In  treating 
the  physical  habitat-versus-streamflow  function  as  surro¬ 
gate  production  function,  the  assumption  is  made  that  the 
value  of  the  instream  flows  is  proportional  to  the  habitat 
produced  by  the  flows.  As  with  other  economic  benefits, 
it  is  desirable  to  know  the  time  series  of  the  benefits 
produced. 
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Figl.l.  Concept  of  a  decision  support  system  using  TSLIB. 
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Fig.  1.2,  The  [^ysical  halntat  fcff  rainbow  trout  in 
the  North  Fork  Snoqualnue  River,  Washington 
(1  /ft  -  0.305  rn^/no;  1  cfe  -  0.028  m^/s). 


.  13.  Monthly  streamflow  and  physical 
habitat  for  adult  rainbow  trout,  1971-74, 
in  the  North  Fork  Snoqualmie  River, 
Washington  (1  ft^/ft  =  0.305  m^/m; 
1  cfs  =  0.028  m^/s). 


Fig.  1.4.  Annual  physical  habitat  for  adult  rain¬ 
bow  trout  in  the  North  Fork  Snoqualmie 
River,  Washington  (1  *  0.305  m^/m; 

1  cfs  =  0.028  m^/s). 
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1980 
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Time  Step 

The  choice  between  a  daily  or  monthly  time  series 
analysis  depends  on  the  objective  of  the  analysis  and  on 
the  data  and  funds  available.  For  example,  daily  values 
could  be  used  for  a  gaged  site  and  where  the  water  resource 
system  is  being  simulated  using  daily  flows.  In  contrast, 
monthly  streamflows  would  be  used  for  a  location  with 
few  streamflow  measurements  and  where  the  streamflow 
record  was  synthesized  by  regression  with  nearby  sites. 
Usually  a  time  series  of  daily  habitat  is  transformed  to  an 
index  of  monthly  habitat  for  further  analysis.  The  monthly 
habitat  values  are  often  transformed  to  some  type  of  annual 
habitat  index,  which  is  (in  most  situations)  the  actual 
decision  variable.  The  exception  to  this  general  pattern  is 
where  dual  habitats  are  being  considered  in  the  analysis — 
in  that  situation,  the  annual  index  is  developed  directly 
from  annual  values  of  streamflows. 

Average  monthly  data  were  used  to  generate  the  time 
series  of  physical  habitats  in  Fig.  1.3.  If  daily  flows  were 
used  and  the  results  averaged  to  arrive  at  the  average 
monthly  habitat  values,  the  results  would  not  be  the  same. 
In  addition,  a  linear  interpolation  procedure  was  used  to 
develop  the  results  in  Fig.  1.3;  a  nonlinear  procedure  would 
have  resulted  in  different  values.  A  comparison  of  the  habitat 
values  for  one  year,  obtained  by  using  the  different  possible 
generation  procedures,  is  included  in  Table  1.1.  The  differ¬ 
ences  are  not  large  for  the  North  Fork  Snoqualmie  River; 
however,  they  still  illustrate  the  importance  of  using  the 
same  transformation  procedure  when  comparing  data  sets 
such  as  for  pre-  and  postproject  conditions. 


In  most  situations,  a  time  series  of  daily  streamflows 
would  be  the  most  appropriate;  unfortunately,  there  are  few 
situations  where  both  a  pre-  and  a  postproject  time  series  of 
daily  streamflows  is  available.  Never  compare  postproject 
habitat  using  one  time  step  and  preproject  habitat  using 
another  time  step.  If  this  is  done,  a  major  error  will  have  been 
made.  There  are  few  cases  where  daily  habitats  mean  any¬ 
thing,  because  the  biological  system  does  not  respond  to 
daily  conditions  but  to  some  integration  of  conditions  over 
time.  (The  exceptions  to  this  may  be  extreme  events,  such 
as  peak  flows.) 


Organization  of  TSLIB 

The  flow  of  information  through  TSLIB  is  illustrated  in 
Fig.  1 .5.  At  first  glance.  Fig.  1 .5  is  overwhelming,  but  Figs. 
1.6  through  1.8  are  a  breakdown  of  each  step.  Figure  1.6 
illustrates  the  need  to  first  obtain  a  habitat-versus-stream- 
flow  function  and  streamflow  data.  The  next  step  is  to 
transform  the  time  pattern  of  streamflows  to  a  time  pattern 
of  habitats.  The  analyst  must  then  decide  if  the  analysis  of 
the  resulting  habitat  time  series  is  to  be  done  using  monthly 
data  or  to  use  annual  data — or,  in  some  situations,  both. 
TSLIB  is  no  more  complex  than  the  analyst  chooses  to 
make  it.  A  goal  in  the  design  of  TSLIB  is  to  make  it 
possible  for  the  user  to  design  an  approach  to  a  problem 
and  not  be  constrained  by  another  analyst’s  simplifying 
assumptions.  It  is  possible  to  use  either  monthly  or  daily 
streamflow  data — the  choice  of  a  time  step  will  be  dis¬ 
cussed  later. 


Table  1.1.  Comparison  of  the  habitat  values  that  resulted from  dijferent  habitat  generation  procedures  for  adult  brown 
trout  (Salmo  trutta)  in  the  North  Fork  Snoqualmie  River,  Washington. 


Month 

Daily  streamflows 

Monthly  streamflows 

Linear 

(ftVft)‘ 

Linear 

(ftW 

Nonlinear 

(ftVft)* 

October  1972 

15.9 

17.5 

17.8 

November  1972 

19.2 

22.6 

22.6 

December  1972 

18.1 

18.1 

18.0 

January  1973 

21.0 

20.8 

20,8 

February  1973 

19.0 

20.2 

20.4 

March  1973 

21.7 

22.9 

23.2 

April  1973 

22.1 

23.2 

23.5 

May  1973 

21.4 

21.3 

21.3 

June  1973 

21.4 

21.6 

21.6 

July  1973 

15.7 

17.0 

17.2 

August  1973 

7.4 

7.4 

7,4 

September  1973 

11.4 

15.7 

15.8 

•  1  fF/ft  =  0.305  mV- 
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GENERAL  TIME  SERIES  FLOWCHART 
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Habitat 


Monthly  Flow 


Fig.  1.5.  Flow  of  information  through  the  TSLIB  programs. 
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Fig.  1.6.  TSLIB  in  its  simplified  form. 
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Fig.  1.7.  Analytical  path  when  monthly  streamflow  data  are  used. 


The  next  level  of  complexity  is  illustrated  in  Fig.  1.7  for 
the  use  of  monthly  streamflow  data.  The  diagram  is  similar 
to  Fig.  1 .6  except  for  the  addition  of  programs  that  allow  the 
user  to  transfer  streamflow  data  either  as  an  operations  study 
of  a  reservoir  or  to  develop  streamflows  at  ungaged  sites. 
The  added  programs  all  work  with  monthly  time-steps. 

Figure  1.8  is  the  same  level  of  complexity  as  Fig.  1.7, 
except  that  daily  time  steps  in  streamflows  are  used,  as 
opposed  to  monthly  time  steps.  The  resulting  habitat  time 
series  may  either  be  daily  or  monthly  at  the  option  of  the 
user.  To  use  TSLIB  to  analyze  the  time  series,  the  results 
from  the  transformation  of  the  streamflow  data  to  physical 


habitat  must  be  a  monthly  habitat  time  series.  For  daily 
habitats,  the  user  must  supply  the  programs  or  perform  the 
analysis  by  hand. 


Organization  of  the  Manual 

Chapter  2  of  this  manual  presents  programs  to  acquire, 
enter,  manipulate,  and  list  streamflow  data.  Sources  for 
stream  measurements  include  the  Soil  Conservation  Serv¬ 
ice,  the  U.  S.  Geological  Service  (USGS)  National  Water 
Data  Exchange  (NAWDEX),  the  USGS  National  Water 


Fig.  1.8.  Analytical  path  when  daily  streamflow  data  are  used. 
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Data  Storage  and  Retrieval  System  (WATSTORE),  the 
Environmental  Protection  Agency’s  STORET,  water  con¬ 
servation  or  irrigation  districts,  national  parks  and  forests, 
city  water  departments,  and  private  firms. 

Information  on  the  entry  and  manipulation  of  the  habi- 
tat-versus-streamflow  function  is  presented  in  Chapter  3. 
Users  of  TSLIB  are  responsible  for  obtaining  a  credible 
physical  habitat  area-versus-streamflow  function  for 
each  life  stage  and  species  to  be  analyzed.  This  function 
may  be  output  from  the  habitat  simulation  programs  in 
the  Physical  Habitat  Simulation  System  (PHABSIM)  or 
can  be  entered  directly  by  the  user.  The  programs  pre¬ 
sented  in  Chapter  3  are  intended  to  help  the  user  display 
the  habitat  area-versus-streamflow  function  in  different 
ways  and  to  manipulate  the  function  with  a  goal  of  better 
understanding  the  nature  of  the  system  being  analyzed. 

In  many  instream  flow  investigations,  the  site  where  the 
analysis  is  desired  is  not  at  the  same  location  as  where 
streamflow  data  are  available.  Usually  it  is  the  responsi¬ 
bility  of  the  project  sponsor  to  transfer  the  streamflow  data 
from  the  location  where  information  is  available  to  the  site 
where  the  instream  flow  analysis  is  desired.  In  some  situ¬ 
ations,  the  instream  flow  analyst  needs  to  do  the  transfer¬ 
ring.  The  programs  presented  in  Chapter  4  allow  the  in- 
stream  flow  analyst  to  make  relatively  simple  transferrals. 
Users  interested  in  more  complex  approaches  should  con¬ 
tact  experts  in  the  area  or  develop  their  own  programs. 

The  objective  of  many  instream  flow  studies  is  to  com¬ 
pare  various  water  management  schemes.  These  schemes 
may  include  both  structural  and  nonstructural  considera¬ 
tions:  Structural  considerations  include  the  sizes  and  loca¬ 
tions  of  reservoirs  and  diversions;  nonstructural  considera¬ 
tions  are  the  rules  for  the  operation  of  the  reservoir  at  the 
diversion.  Usually,  the  analysis  of  the  water  resource 
system  will  be  done  by  the  sponsoring  agency  or  group, 
and  the  streamflows  for  the  various  operational  alterna¬ 
tives  will  be  made  available  by  the  sponsor.  The  instream 
flow  analyst  will  (or  at  least  should)  be  involved  in  the 
selection  of  some  of  the  alternatives  (always  be  wary  of 
choosing  the  best  from  among  a  set  of  poor  alternatives). 
The  instream  flow  work  then  proceeds  through  the  various 
time  series  analysis  using  the  sponsor’s  streamflow  (manage¬ 
ment)  alternatives — there  is  no  need  for  the  instream  flow 
analyst  to  do  any  water  resource  systems  analysis. 

Occasionally,  the  need  does  arise  for  the  instream  flow 
analyst  to  do  an  analysis  of  the  water  resource  system. 
Usually  this  is  due  to  the  sponsor  refusing  to  study  viable 
alternatives  or  having  limited  ability  to  do  a  water  resource 
systems  analysis.  The  programs  presented  in  Chapter  5  are 
fairly  simple  water  resource  systems  models  that  can  be 
used  for  the  analysis  in  many  water  resource  systems  with 
which  the  instream  flow  analyst  comes  into  contact.  For 
more  complex  systems,  the  analyst  should  consider  using 


programs  available  from  the  Bureau  of  Reclamation  or  the 
U.S.  Army  Corps  of  Engineers,  as  well  as  programs  avail¬ 
able  from  other  groups. 

The  time  series  can  be  generated  using  one  of  two  time 
steps — daily  or  monthly.  The  programs  used  to  generate  a 
daily  time  series  of  habitats  are  discussed  in  Chapter  6. 
Since  the  only  programs  available  to  review  daily  habi¬ 
tat  values  either  simply  display  the  values  or  transform 
the  daily  values  to  a  monthly  index,  these  analysis  pro¬ 
grams  are  included  in  Chapter  6.  The  program  that  goes 
directly  from  a  duration  curve  of  streamflow  to  a  dur¬ 
ation  curve  of  physical  habitats — called  DQDUR — ^is 
also  included. 

Chapter  7  consists  of  information  on  programs  used 
to  generate  the  time  series  of  monthly  habitats.  The 
HABTS  program  is  the  foundation  for  generating  monthly 
habitat  time  series  data  for  a  single  river  segment;  the 
HABNET  program  performs  the  same  function  for  a 
stream  network. 

The  monthly  streamflow  and  physical  habitat  values 
by  themselves  give  little  information  until  they  are  ana¬ 
lyzed  and  the  results  displayed.  The  programs  presented 
in  Chapter  8  are  used  to  manipulate,  analyze,  and  display 
the  monthly  time  series  data.  In  many  situations,  this 
should  be  considered  an  intermediate  step  before  pro¬ 
ceeding  to  the  generation  of  an  aimual  time  series. 

In  many  instream  flow  analyses,  the  time  series  of  an¬ 
nual  habitats  is  the  most  useful.  The  programs  used  to 
generate  a  time  series  of  annual  habitats  from  the  monthly 
time  series  of  physical  habitats  are  discussed  in  Chapter  9. 
There  are  three  approaches  to  using  annual  habitats: 
(1)  The  use  of  the  annual  adult  habitat  time  series  for  each 
life  stage  assumes  that  the  time  series  for  adults  represents 
the  year-to-year  variation  of  the  worth  of  the  stream  for  a 
species  of  aquatic  animal;  (2)  the  use  of  the  annual  equiva¬ 
lent  adult  habitat  time  series  assumes  that  each  year  is 
independent  of  the  preceding  year  but  that  each  life  stage 
must  be  considered;  and  (3)  the  use  of  annual  effective 
adult  habitat  time  series  does  not  assume  that  each  year  is 
independent  of  the  preceding  year. 


Summary 

The  TSLIB  library  is  a  collection  of  programs  that  allow 
the  user  to  design  an  approach  to  time  series  analysis.  There 
are  programs  to  assist  in  the  manipulation  of  the  time  series 
of  streamflows  and  the  physical  habitat-versus-streamflow 
function.  At  the  heart  of  the  libraiy  are  the  programs  that 
transform  the  streamflow  time  series  to  a  physical  habitat 
time  series.  The  first  two  sets  of  programs  are  those  that 
analyze  a  monthly  time  series  or  an  annual  time  series  of 
habitats. 
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Fig.  IS.  Comparison  of  physical  habitat  in  June 
for  adult  channel  catfi^  in  the  Maraie  des 
Cygnes  River  below  Melvem  Reservoir, 
with  alternative  instream  flow  criteria  and 
30  cfs  diversion  (1  *  0.305  m^/m). 


A  principle  use  of  the  monthly  physical  habitat  time 
series  is  to  compare  alternative  water  management 
schemes.  One  approach  is  to  compare  duration  curves 
(Fig.  1.9).  The  duration  curves  for  alternative  projects  or 
water  allocation  rules  can  be  compared  to  help  select  the 
best  overall  alternative.  The  specific  comparison  in 


Fig.  1.9  is  of  two  alternative  instream  flow  criteria,  one 
proposed  by  the  U.S.  Fish  and  Wildlife  Service  and  the 
other  by  the  U.S.  Army  Corps  of  Engineers. 

For  additional  information  on  the  use  of  the  monthly 
time  series  of  physical  habitat,  see  Bovee  (1982: 
Chapter  5). 
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Chapter  2. 

Acquisition,  Entry,  Manipulation,  and  Listing  of 
Streamflow  Data 


Introduction 

Streamflow  data  for  many  rivers  may  be  obtained  from 
the  U.S.  Geological  Survey  (USGS),  which  maintains  a 
network  of  gaging  stations  throughout  the  United  States. 
Normally  gages  are  located  on  the  larger  streams  and  rivers 
and  may  not  be  available  in  smaller  watersheds.  Typically, 
the  streamflow  measurements  will  reflect  mean  daily  or 
mean  monthly  flows;  further  manipulations  would  be  re¬ 
quired  for  any  other  time-step.  Sources  for  stream  meas¬ 
urements  include  the  Soil  Conservation  Service,  the  USGS 
National  Water  Data  Exchange  (NAWDEX),  the  USGS 
National  Water  Data  Storage  and  Retrieval  System 
(WATSTORE),  the  Bivironmental  Protection  Agency’s 
STORET,  water  conservation  or  irrigation  districts,  na¬ 
tional  parks  and  forests,  city  water  departments,  and  pri¬ 
vate  firms. 

Recently  Earthinfo,  a  private  firm,  has  gained  some 
prominence  in  supplying  a  variety  of  environmental  librar¬ 
ies  of  time  series  data  on  compact  disk  read  only  memory 
(CD-ROM)  for  personal  computers.  Among  their  offer¬ 
ings  is  a  copy  of  the  USGS  WATSTORE  data  base  called 
Hydrodata,  which  includes  daily  values,  peak  values,  re¬ 
marks,  and  quality  of  water.  Another  product,  Climate- 
data,  includes  an  extensive  data  base  of  air  temperatures 
useful  for  water  temperature  modeling.  Finally,  Earthinfo 
offers  products  we  have  not  investigated,  such  as  Canadian 
surface  water  data  and  Colorado  water  rights  tabulations. 

Earthinfo  data  bases  come  with  a  variety  of  fairly 
straightforward  software  to  search,  extract,  and  convert  the 
required  data  to  formats  necessary  as  input  to  TSLIB 
programs.  They  can  also  supply  additional  software  for 
commonly  used  statistical  and  analysis  techniques  (at  ad¬ 
ditional  cost).  In  essence,  if  you  can  access  Hydrodata, 
you  can  eliminate  learning  about  the  USGS’s  Amdahl,  a 
microcomputer  communications  package,  and  the  TSLIB 
programs  DAILY,  DURTBL,  GETREL,  INVENT, 
MESS,  PEAK,  and  PAGEBR.  These  will  be  replaced  by 
equivalent,  but  mostly  simpler,  functions  in  the  Earthinfo 
software. 

This  manual  concentrates  on  the  use  of  WATSTORE, 
as  it  is  a  public  data  source;  however,  we  encourage  you 
to  look  into  Earthinfo.  We  have  found  that  the  Earthinfo 


data  bases  are  often  available  at  land  grant  university 
libraries  and  other  places  that  deal  with  WATSTORE 
data  on  a  regular  basis.  For  more  information,  contact 
Earthinfo  (formerly  US  West  Optical  Publishing), 
5541  Central  Avenue,  Boulder,  Colorado  80301;  phone 
number  (303)  938-1788. 

Gathering  or  collecting  hydrologic  data  is  covered  in  a 
variety  of  publications  (Bovee  1982;  Milhous  and  Bovee 
1978;  Hamilton  and  Bergensen  1984). 

When  referring  to  streamflow  data,  a  year  may  be  con¬ 
sidered  as  several  different  time  periods — ^for  example, 
calendar  year,  water  year,  climatological  year,  power  year, 
fish  year,  and  so  forth.  Be  sure  that  you  understand  what 
type  of  year  is  being  referred  to  when  using  the  TSLIB 
programs;  WATSTORE  data  is  in  water  years.  Figure  2. 1 
diagrams  the  various  types  of  years. 


Acquiring  Streamflow  Data  Using  the 
WATSTORE  Data  Base 

The  Water  Resources  Division  of  the  U.S,  Geological 
Survey  supports  the  National  Water  Data  Storage  and 
Retrieval  System  (WATSTORE).  WATSTORE  is  a 
computer-based  data  management  system  centrally  lo¬ 
cated  at  the  USGS  National  Center  in  Reston,  Virginia.  It 
is  designed  to  receive,  store,  and  distribute  data  per¬ 
taining  to  the  nation’s  water  resources.  Relevant  hydro- 
logic  data  include  surface  water  measurements,  ground 
water  measurements,  water  quality  variables,  and 
water  use  statistics. 

Of  particular  interest  to  TSLIB  users  are  the  daily  and 
peak  streamflow  measurements  for  sites  throughout  the 
United  States.  Approximately  16,000  stream  gaging  sta¬ 
tions  are  currently  in  operation  recording  data  to  be  added 
to  the  following  files: 

1.  Daily  values  file — a  compilation  of  current  and  his¬ 
torical  data  observations  made  on  a  daily  or  continu¬ 
ous  basis;  includes  daily  streamflow  records. 

2.  Peak fiows  file — a  collection  of  peak  discharges  and 
associated  gage-height  data  in  an  on-line  file. 


Acquiring  Streamflow  Data 
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I - Calendar  Years  - 1 

\ - -  1975  - 1 - -  1976  - 1 

|J|F|M|A|M|J|J|A|S|0|N|D|J|F|M|A|M|J|J|A|S|0|N|D| 

I -  1976  Water  Year  - (  Fig.  2.1.  Diagram  of  yearly  time  periods. 

I _  1975  Climatological  Year  _ j 

j _ Power  Year _ . 

I  (Columbia  Basin)  ' 

I _ 1976  Fish  Year _ . 

•  Flathead  Catfish  1 


Programs  have  been  developed  to  provide  tisers  with  a 
method  for  retrieving  information  from  WATSTORE. 
These  programs  interactively  prompt  the  user  with  a  series 
of  questions  pertaining  to  the  type  of  data  desired.  After 
the  questions  are  completed,  an  output  file  is  produced  in 
the  form  of  a  WATSTORE  request  job.  This  file  is  trans¬ 
ferred  to  the  uses  Amdahl  mainframe  computer  using  a 


microcomputer  communications  software  package  and 
submitted  for  execution  on  the  Amdahl.  See  Appendix 
for  information  on  running  WATSTORE  on  the  USGS 
Amdahl  computer.  Users  are  responsible  for  obtaining 
their  own  communications  software  package. 

Figure  2.2  is  a  flowchart  of  the  flow  of  information 
through  WATSTORE. 


.a  o 


User  Functions 
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Program 

Name 

MESS 


GETREL 


DAILY 


DLRTBL 


Acquiring  Streamflow  Data  Using  WATSTORE 


BatclVProcedure 

Filename  Rmetion 


RMESS  Streamflow 
data 

acquisition 


RGETREL  Streamflow 
data 

acquisition 


RDAILY  Streamflow 
data 

acquisition 


RDURTBL  Streamflow 
data 

acquisition 


Program  Description 


Generates  a  WATSTORE  message  request  file  to  retrieve  data  from 
the  WATSTORE  data  base  for  use  with  the  GETREL  program. 


RMESS,  WATREQ 


WATREQ  =  Request  file  to  obtain  WATSTORE  message  file 
(output). 

Processes  the  WATSTORE  message  file  (obtained  by  submitting  the 
file  created  by  the  MESS  program)  and  generates  a  file  of  tape  reel 
numbers  from  the  daily  values  backfile.  This  file  is  used  by  the 
DAILY,  DURTBL,  and  INVENT  programs  when  generating  a 
request  job  from  WATSTORE. 

RGETREL,  WATMESS,  REELNO 

WATMESS  =  WATSTORE  message  file  (input). 

REELNO  =  File  of  tape  reel  numbers  from  the  daily  values  back- 
file  (output). 

Generates  a  mean  daily  streamflow  values  request  file  to  retrieve 
data  from  the  WATSTORE  data  base. 

RDAILY,  REELNO,  WATREQ 


REELNO  =  File  of  tape  reel  numbers  from  the  daily  values  backfile 
(input).  This  file  was  created  by  the  GETREL  program. 


WATREQ  =  WATSTORE  request  file  to  obtain  mean  daily  stream- 
flow  values  (output). 

Generates  a  daily  streamflow  values  duration  table  request  file  to 
retrieve  data  from  the  WATSTORE  data  base.  The  retrieved  data 
can  be  used  as  input  to  the  DQDUR  program  (Chapter  6). 

RDURTBL,  REELNO,  WATREQ 


REELNO  =  File  of  tape  reel  numbers  from  the  daily  values  backfile 
(input).  This  file  was  created  by  the  GETREL  program. 

WATREQ  =  WATSTORE  request  file  to  obtain  daily  streamflow 
values  duration  table  (output). 
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Program  BatclVProcediire 

Name  Hlename  Hinction  _ Program  Description _ 

INVENT  RINVENT  Streamflow  Generates  a  station  inventory  request  file  to  inventory  daily  values 

data  data  from  the  WATSTORE  data  base, 

acquisition 

RINVENT,  REELNO,  WATREQ 


REELNO  =  File  of  tape  reel  numbers  from  the  daily  values  backfile 
(input).  This  file  was  created  by  the  GETREL  program. 


WATREQ  =  WATSTORE  request  file  to  obtain  an  inventory  of 
daily  values  data  (output). 


PEAK  RPEAK  Streamflow  Generates  a  peak  streamflow  values  request  file  to  retrieve  data 

data  from  the  WATSTORE  data  base, 

acquisition 

RPEAK,  WATREQ 


WATREQ  =  WATSTORE  request  file  to  obtain  peak  streamflow 
values  (output). 


Direct  Entry  of  Streamflow  Data 

Program  Batch/Procedure 

Name  Filename  Rinction  _ Program  Description _ 

QIN  RQIN  Streamflow  Creates  a  streamflow  data  file  in  WATSTORE  or  USGS  format  from 

data  keyboard  entry  or  from  a  free-formatted  ASCII  file  created  with  an 

entry  editor.  Type  INFODQ  or  INFOMQ  for  information  on  the  format  of 

the  free-formatted  input  file  for  daily  or  monthly  streamflow. 


RQIN,ZQFIL,ZQIN 


ZQFIL  =  Daily  streamflow  file  in  WATSTORE  format  or  monthly 
streamflow  file  in  USGS  format  (output). 


ZQIN  Free-formatted  ASCII  text  file  containing  responses  to  pro¬ 
gram  prompts.  If  no  filename  is  entered,  keyboard  input  is 
assumed  (input). 


Manipulation  of  Streamflow  Data 
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Program  BatclVProcedure 
Name  Hlcname 

CHGFMT  RCHGFMT 


DQFY  RDQFY 


DQTOMQ  RDQTOMQ 


PAGEBR  RPAGEBR 


Manipulation  of  Streamflow  Data 


Rmctictfi 

Monthly 
time  series 
manipulation 


Streamflow 

data 

manipulaticm 


Streamflow 

data 

manipulaticai 


Streamflow 

data 

manipulaticxi 


_ Program  Descripticai _ 

Changes  a  USGS  format  file  to  a  NWDC  format  file  (or  vice  versa). 

RCHGFMT,  ZMTS,  ZMTSN 


ZMTS  =  Monthly  time  series  file  in  USGS  or  NWDC  format;  can 
be  multirecord  file  (input). 

ZMTSN  =  New  monthly  time  series  file  in  NWDC  or  USGS  for¬ 
mat;  will  be  multirecord  if  ZMTS  is  (output). 


Removes  incomplete  years  from  a  daily  streamflow  file  in  WAT- 
STORE  format  for  use  with  the  CEDUR,  DQTOMQ,  and  HABTD  pro¬ 
grams.  DQFY  also  removes  excess  title  lines  (files  from  Hydrodata 
contain  extra  title  lines). 

RDQFY,  ZDQ,  ZDQN 

ZDQ  =  Daily  streamflow  file  in  WATSTORE  format  (input). 


ZDQN  =  New  daily  streamflow  file  in  WATSTORE  format  with 
complete  years  and  2  title  lines  (output). 

Reads  a  daily  streamflow  file  in  WATSTORE  format  and  writes  a 
monthly  streamflow  file  in  NWDC  format. 

RDQTOMQ,  ZDQ,  ZMONQ 


ZDQ  =  Daily  streamflow  file  in  WATSTORE  format  (input).  This 
file  must  have  been  run  through  DQFY  to  remove  incom¬ 
plete  years  and  excess  title  lines. 

ZMONQ  Monthly  streamflow  file  in  NWDC  format  (output). 

Prepares  a  WATSTORE  output  file  (generated  using  the  request  file 
created  by  the  DAILY,  DURTBL,  INVENT,  or  PEAK  programs)  for 
printing.  PAGEBR  inserts  a  printer  control  character  where  printing 
should  begin  on  a  new  page. 

RPAGEBR,  ZIN,  ZOUT 


ZIN  =  WATSTORE  output  file  (input). 


ZOUT  =  WATSTORE  output  file  with  page  breaks  (output). 
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Program  Batch/Ptocedure 
Name  Hlenan^  Ruction 


SELDUR  RSELDUR 


Stieamflow 

data 

manijHdaticxi 


RDgramI>esaiptioii 


Takes  a  WATSTORE  duration  analysis  file  (created  by  submitting 
the  request  file  created  by  DURTBL  to  WATSTORE)  ami  creates  a 
smaller  file  with  the  same  information,  which  can  be  used  as  input 
to  the  DQDUR  program  (Chapter  6). 

RSELDUR,  WATDUR,  ZREDUR 

WATDUR  *=  WATSTORE  duration  analysis  file  (input). 


ZREDUR  =  Reduced  WATSTORE  duration  analysis  file  (output). 


Listing  of  Streamflow  Data 


Program  Batch/Procedure 

Name  Filename  Rinction  _ Program  Descripdon 


CEDUR  RCEDUR  Streamflow  Analyzes  a  daily  flow  file  and  produces  six  different  reports,  includ- 

data  ing  daily,  monthly,  and  yearly  data  summaries;  flow  exceedence 

listing  percentages  by  month  or  by  a  user-defined  period;  and  percentage 

exceedence  flows  for  user-defined  percentages. 


RCEDUR,  ZDQ,ZOUT 


ZDQ  *  Daily  streamflow  file  in  WATSTORE  format  (input).  This 
file  must  have  been  run  through  the  DQFY  program  to 
remove  incomplete  years  and  extra  title  lines. 

ZOUT  =  Data  summaries,  exceedence  percentages,  and  percentage 
exceedence  flows  (output). 


LSTDQ  RLSTDQ  Streamflow  Writes  a  file  containing  header  information  and  title  lines  or  informa- 

data  tion  by  water  years  in  a  daily  streamflow  file.  WATSTORE  files 

listing  may  contain  several  data  sets  with  individual  title  lines. 


RLSTDQ,  ZDQ,  ZOUT 


ZDQ  =  Daily  streamflow  file  in  WATSTORE  format  (input). 

ZOUT  “  LSTDQ  results  (output).  If  filename  is  not  specified  and 
only  headings  are  requested,  output  will  go  to  the  screen. 


Refer  to  Appendix  A  for  a  sample  daily  streamflow  file  in  WATSTORE  format  (ZDQ)  and  a  monthly  streamflow  file 
in  U.S.  Geological  Survey  (USGS)  and  Northwest  Water  Data  Center  (NWDC)  format  (ZMONQ). 


CEDUR  Program 
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CEDUR  Program 


Introduction 

The  CEDUR  program  analyzes  a  daily  flow  file  and 
produces  six  different  reports,  including  daily,  monthly, 
and  yearly  data  summaries;  flow  exceedence  percentages 
by  month  or  by  a  user-defined  period;  and  percentage 
exceedence  flows  for  user-defined  percentages. 

Running  CEDUR 

RCEDUR,  ZDQ,  ZOUT 

ZDQ  =  Daily  streamflow  file  in  WATSTORE 
format  (input);  (this  file  must  have  been 
run  through  the  DQFY  program  to  re¬ 
move  incomplete  years  and  extra  title 
lines). 

ZOUT  =  Data  summaries,  exceedence  percent¬ 
ages,  and  percentage  exceedence  flows 
(output). 

YOO  MAY  CHOOSE  ANY  OR  ALL  OF  THESE  «  REPORTS  i  ’ 

•:  l./MOWntLY  FLOW  STATISTICS  FOR  EACH  YEAR 
2  OAILY  FLOW  STATISTICS  FOR  ALL  YEARS  COMBINED  . 

.  3  MONTHLY  FLOW  STATISTICS  FOR  ALL  YEARS  COMilNEb  . 

■■■.=••4 ■■'MEAN  MONTHLY  FLOW  STATISTICS 

S  BAILY  flow  duration  by  given  time  pERIODlv-W^^ 

tjAILY  FLOW  DURATION  BY  MONTHS 

TO  SELECT  A  REPORT,  Q  TO  TURN  DOWNfA^REPORT;.' . 


Enter  the  appropriate  number  (1  or  0)  below  the  report 
number  to  indicate  what  reports  you  want.  See  Figs.  2.3- 
2.7  for  sample  output  for  each  report. 


If  you  get  one  of  the  error  messages,  ERROR  IN 
DAILY  FLOW  FILE— PLEASE  CHECK  YOUR 
DATA  SET  or  ERROR— INCOMPLETE  YEAR, 
check  to  ensure  that  you  ran  the  daily  flow  file  through 
the  DQFY  program  to  remove  incomplete  years  and 
extra  title  lines. 


Option  1 

Figure  2.3  contains  sample  output  if  option  1,  Monthly 
flow  statistics  for  each  year,  is  selected.  This  option  prints 
out  the  maximum,  minimum,  average,  and  median  flow 
for  each  month  of  each  year.  It  also  indicates  the  day  of  the 
maximum  and  minimum  flows. 

Option  2 

Figure  2.4  contains  sample  output  if  option  2,  Daily  flow 
statistics  for  all  years  combined,  is  selected.  This  option 
prints  out  the  maximum,  minimum,  average,  and  median 
flow  for  each  day  of  the  year  and  indicates  the  year  of  the 
maximum  and  minimum  flows.  This  option  is  only  useful 
if  more  than  one  year  of  data  is  in  the  daily  streamflow  file. 

Option  3 

Figure  2.5  contains  sample  output  if  option  3,  Monthly 
flow  statistics  for  all  years  combined,  is  selected.  This 
option  prints  out  the  maximum,  minimum,  average,  and 
median  flow  for  each  month  and  indicates  the  year  and  the 
day  for  the  maximum  and  minimum  flows.  The  maximum, 
minimum,  and  average  flows  for  the  entire  streamflow  file 
are  also  printed. 


DATE  -  90/03/28.  H  12142000  4736541214244005353033SW17110010  64.00  1130.00  PROGRAM  ■  CEDUR 

TIME  -  09.37.45.  N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA.  PAGE  -  1 

*****  monthly  flow  data  ***** 


MONTH 

YEAR 

MAXIMUM 

DAY 

MINIMUM 

DAY 

AVERAGE 

MEDIAN 

COUNT 

OCT 

1970 

1370.00 

9 

116.00 

4 

363.84 

288.00 

31 

NOV 

1970 

3090.00 

24 

152.00 

5 

588.87 

400.00 

30 

DEC 

1970 

2550.00 

6 

165.00 

25 

480.13 

282.00 

31 

JAN 

1970 

4050.00 

19 

158.00 

6 

937.68 

796.00 

31 

FEB 

1970 

2270.00 

13 

308.00 

28 

834.11 

530.00 

28 

MAR 

197  0 

1100.00 

30 

215.00 

21 

396.55 

310.00 

31 

APR 

1970 

725.00 

27 

288.00 

19 

444.27 

412.00 

30 

MAY 

1970 

1670.00 

12 

601.00 

18 

1053.77 

1010.00 

31 

JUN 

1970 

1420.00 

22 

556.00 

29 

875.37 

808.00 

30 

JUL 

1970 

1110.00 

10 

476.00 

31 

717 .16 

650.00 

31 

AUG 

1970 

428.00 

1 

89.00 

29 

176.84 

148.00 

31 

SEP 

1970 

677.00 

2 

80.00 

23 

208.37 

160.00 

30 

ALL  MONTHS 

1970 

4050.00 

JAN  19 

80.00 

SEP 

23  588.40 

450.00 

365 

Fig.  23.  Sample  output  when  option  1  is  chosen  in  the  CEDUR  program. 
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DATE  ■ 
TIME  - 


Fig.  2.4 


DATE  - 
TIME  - 


90/03/28. 
10.06.57  . 

H 

N 

12142000 

12142000 

4736541214244005353033SW17110010  64.00  1130.00 

N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

PROGRAM 

PAGE 

-  CEDUR 

1 

*****  daily  flow  data  ***** 

DAY 

MONTH 

MAXIMUM 

YEAR 

MINIMUM 

YEAR 

AVERAGE 

MEDIAN 

COUNT 

1 

OCT 

468.00 

1981 

51.00 

1974 

202.25 

138.00 

12 

2 

OCT 

1480.00 

1981 

62.00 

1979 

268.58 

129.00 

12 

3 

OCT 

578.00 

1981 

59.00 

1979 

180.58 

141.00 

12 

4 

OCT 

376.00 

1981 

56.00 

1979 

158.58 

156.00 

12 

5 

OCT 

431.00 

197  0 

54.00 

1979 

174.33 

156.00 

12 

6 

OCT 

1570.00 

1981 

53.00 

1979 

280.17 

146.00 

12 

7 

OCT 

1530.00 

1981 

51.00 

1979 

268.25 

145.00 

12 

8 

OCT 

1130.00 

1981 

50.00 

1979 

223 . 83 

137.00 

12 

9 

OCT 

1370.00 

1970 

50.00 

1979 

330.33 

131.00 

12 

10 

OCT 

766.00 

1970 

49.00 

1974 

249.08 

145.00 

12 

11 

OCT 

547 .00 

1981 

48.00 

1979 

200.58 

153.00 

12 

12 

OCT 

764.00 

1973 

47.00 

1974 

226.67 

128.00 

12 

13 

OCT 

2440.00 

1973 

45.00 

1974 

394.33 

145.00 

12 

14 

OCT 

1110.00 

1973 

44.00 

1974 

253.75 

144.00 

12 

15 

OCT 

684.00 

1975 

44.00 

1974 

230.33 

131.00 

12 

16 

OCT 

367.00 

1975 

43.00 

1974 

179.83 

123.00 

12 

17 

OCT 

654.00 

1975 

41.00 

1974 

189.58 

117.00 

12 

18 

OCT 

1250.00 

1975 

40.00 

1974 

230.75 

112.00 

12 

19 

OCT 

1110.00 

1975 

40.00 

1974 

290.92 

138.00 

12 

20 

OCT 

790 . 00 

1971 

44.00 

1974 

255.42 

147.00 

12 

21 

OCT 

507.00 

1975 

47 .00 

1974 

218.67 

143.00 

12 

22 

OCT 

499 . 00 

1975 

46.00 

1974 

202.33 

124.00 

12 

23 

OCT 

710.00 

1970 

44.00 

1974 

230.25 

148.00 

12 

24 

OCT 

740.00 

1970 

42.00 

1974 

269.33 

247.00 

12 

25 

OCT 

802.00 

1977 

41.00 

1974 

368.08 

406.00 

12 

26 

OCT 

2280.00 

1971 

40.00 

1974 

502.50 

330 . 00 

12 

27 

OCT 

767.00 

1979 

40.00 

1974 

333.83 

273.00 

12 

28 

OCT 

853.00 

1979 

48.00 

1974 

337.67 

245.00 

12 

29 

OCT 

1420.00 

1975 

53.00 

1974 

408.58 

248.00 

12 

30 

OCT 

2450.00 

1975 

54 . 00 

1974 

534.42 

209 . 00 

12 

31 

OCT 

1150.00 

1975 

55.00 

1974 

441.67 

247.00 

12 

.  Sample  output  when  option  2  is  chosen  in  the  CEDUR  program. 


90/03/28.  H  12142000  4736541214244005353033SW17110010  64.00  1130.00  PROGRAM  -  CEDUR 

10.06.57.  N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA.  PAGE  -  1 

*****  FLOW  DATA  BY  MONTH  ***** 


MONTH 

MAXIMUM 

YEAR 

DAY 

MINIMUM 

YEAR 

DAY 

AVERAGE 

MEDIAN 

COUNT 

OCT 

2450.00 

1975 

30 

40. 

1974 

18 

279  . 

17  0. 

372 

NOV 

4350.00 

1971 

4 

60. 

1974 

5 

594  . 

406  . 

360 

DEC 

7400.00 

1975 

2 

132. 

1979 

1 

850. 

487  . 

372 

JAN 

6650.00 

1981 

24 

125. 

197  8 

9 

646  . 

325. 

37  2 

FEB 

7280.00 

1981 

14 

0. 

1972 

29 

609  . 

380. 

339 

MAR 

3540.00 

1971 

6 

156  . 

1975 

8 

485. 

327  . 

372 

APR 

4220.00 

1980 

28 

189  . 

1972 

3 

526  . 

452. 

360 

MAY 

2470.00 

1971 

22 

252. 

1979 

17 

729  . 

642. 

372 

JUN 

3290.00 

1973 

5 

156  . 

1976 

30 

695  . 

615  . 

360 

JUL 

3280.00 

1971 

13 

81. 

1972 

31 

402  . 

290. 

372 

AUG 

1200.00 

1975 

20 

48  . 

1976 

19 

177  . 

128  . 

372 

SEP 

2070 . 00 

1979 

2 

50. 

1972 

17 

238  . 

14  8. 

360 

Fig.  2.5.  Sample  output  when  option  3  is  chosen  in  the  CEDUR  program. 
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Option  4 


For  this  sample  output,  90  days  was  entered. 


Figure  2.6  contains  sample  output  if  option  4,  Mean 
monthly  flow  statistics,  is  selected.  This  option  prints  out 
the  maximum,  minimum,  average,  and  median  flows  for 
each  month  and  indicates  the  year  of  the  maximum  and 
minimum  mean  monthly  flows. 

Option  5 

Figure  2.7  contains  sample  output  if  option  5,  Daily  flow 
duration  by  given  time  period,  is  selected.  This  option 
prompts  the  user  to  enter  a  period  from  5-100  days  and  to 
enter  up  to  17  exceedence  percentages  to  be  calculated. 
The  output  contains  a  flow  duration  table  for  all  of  the  time 
periods,  a  flow  duration  table  for  the  period  entered  (the 
year  is  divided  into  5-100  day  segments),  and  an  ex¬ 
ceedence  flows  table  for  each  period. 

NOTE;  WHEN  USING  THE  OPTXON  FOR  TIME  i»ERIODS^  THE  LAST 

1'IME  PEKtOD  WILL  CONTAIN  THE  REMAINING  DAYS  OF  THE 
YEAR  AND  MAY  NOT  CONTAIN  THE  NUMBER  DP  DAYS 

requested  For  each  time  period. 

ENTER  THE  NUMBER  OP  DAYS  IN  EACH  TIME  PERIOD  (5-100)  ; 


ENTER  THE  NUMBER  OF  EXCEEDENCE  PERCENTAGES  (1-17 > 
TO  BE  CALCULATED; 


For  this  sample  output,  5  was  entered 


ENTER  THE  t  INj  i  TKIS  EXAMPLE  j ;  5  :  EXCEEDENCE  PERCENTAGES  $ 


For  this  sample  output,  20  40  60  80  100  were  the  5 
entries.  These  are  the  percent  exceedence  figures  for  the 
flows  in  the  table  at  the  end  of  the  CEDUR  output 
(Fig.  2.6). 


Option  6 

Option  6,  Daily  flow  duration  by  mraiths,  is  similar  to 
option  5  except  that  the  output  contains  flow  duration 
tables  for  each  month  instead  of  for  a  variable  period.  This 
option  prompts  the  user  to  enter  up  to  17  exceedence 
percentages  to  be  calculated.  The  output  contains  a  flow 
duration  table  for  all  of  the  time  periods,  a  flow  duration 
table  for  each  month,  and  an  exceedence  flows  table  for 
each  month. 


DATE  -  90/03/28.  H  12142000  4736541214244005353033SW17110010  64.00  1130.00  PROGRAM  -  CEDUR 

TIME  -  10.06.57,  N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA.  PAGE  -  1 

*****  YEARLY  FLOW  DATA  ***** 


MAXIMUM 

MONTH  DAY  YEAR 

MINIMUM 

MONTH 

DAY  YEAR 

AVERAGE 

COUNT 

7400.00 

DEC  2 

1975 

0.00 

FEB 

29  1972 

518.59 

4383 

*****  MEAN 

MONTHLY  FLOW  DATA 

***** 

MONTH 

MAXIMUM 

YEAR 

MINIMUM 

YEAR 

AVERAGE 

MEDIAN 

OCT 

526,13 

1981 

50.94 

1974 

278.56 

194.87 

NOV 

969.07 

1977 

134.73 

1979 

594.19 

387 .73 

DEC 

1556.03 

1975 

464.52 

197  8 

849.62 

518.32 

JAN 

1105.45 

1973 

222.06 

197  8 

645.91 

526,13 

FEB 

1294.68 

1981 

211.00 

1972 

610.61 

526.13 

MAR 

1250.29 

1971 

243.87 

1975 

485.35 

500.16 

APR 

874.47 

1980 

279.20 

1974 

526.46 

500.16 

MAY 

1169.74 

1971 

452.23 

1979 

729.36 

526.13 

JUN 

1338.43 

1973 

397 . 57 

1977 

694.96 

527.60 

JUL 

732.74 

1971 

141.94 

1976 

401.65 

524.03 

AUG 

322.84 

1975 

63.58 

1972 

177 .23 

491.03 

SEP 

452.27 

1977 

87.03 

1978 

237.85 

452.75 

Fig.  2.6.  Sample  output  when  option  4  is  chosen  in  the  CEDUR  program. 
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DATE  -  90/03/30.  H  12142000 
TIME  -  09.52.31.  N  12142000 


4736541214244005353033SW17110010  64.00  30.00 

N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 


FLOW  DURATION  TABLE  FOR  ALL  TIME  PERIODS 


PROGRAM  -  CEDUR 
PAGE  -  1 


PERCENT 

PERCENT 

FLOW 

=  / 

FLOW 

«  /  * 

10000.00 

0.00 

8000.00 

0.00 

4000.00 

0.43 

3500.00 

0.62 

1400.00 

5.29 

1200.00 

7.44 

500.00 

35.04 

450.00 

39.52 

200.00 

75.47 

170.00 

80.54 

70.00 

96.33 

60.00 

97 .90 

30.00 

99.93 

25.00 

99.93 

10.00 

99.93 

8,00 

99.93 

4.00 

99.93 

3.50 

99.93 

2.20 

99.93 

2.00 

99.93 

MAXIMUM  FLOW  THIS  PERIOD: 

MINIMUM  FLOW  THIS  PERIOD: 


FLOW 

PERCENT 
=  /  + 

FLOW 

PERCENT 
=  / 

7000.00 

0.05 

6000.00 

0.11 

3000.00 

0.98 

2500.00 

1.55 

1000.00 

11.00 

800 . 00 

16.22 

400.00 

44.95 

350.00 

51.13 

140.00 

85.63 

120.00 

88.84 

50.00 

99.27 

45.00 

99.66 

20.00 

99.93 

17 .00 

99.93 

7.00 

99.93 

6.00 

99.93 

3.00 

99.93 

2 . 80 

99.93 

1.80 

99.93 

>0.0 

0.0 


FLOW 

PERCENT 

=  / 

PERCENT 
FLOW  =  /  + 

5000.00 

0.21 

4500.00 

0.27 

2000.00 

2.58 

1700.00 

3.47 

700.00 

20.72 

600.00 

26.67 

300.00 

58.77 

250.00 

67.15 

100.00 

91.81 

80.00 

94.84 

40.00 

99.93 

35,00 

99.93 

14.00 

99.93 

12.00 

99  .93 

5.00 

99.93 

4.50 

99.93 

2.60 

99.93 

2.40 

99.93 

DAYS  IN  PERIOD: 


4383 


DATE  '  90/03/30.  H  12142000 
TIME  -  09.52.31.  N  12142000 


4736541214244005353033SW17110010  64.00  30.00 

N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 


PROGRAM  -  CEDUR 
PAGE  -  1 


FLOW  DURATION  TABLE  FOR  TIME  PERIOD  FROM  1  OCT  TO  29  DEC 


PERCENT 
FLOW  =  /  + 

FLOW 

PERCENT 
=  / 

7500.00 

0.00 

7000.00 

0.09 

4500.00 

0.46 

4000.00 

0,83 

2600 . 00 

2.78 

2400.00 

3.24 

1500.00 

7 .69 

1400.00 

8.70 

900.00 

16.30 

800.00 

18.61 

550.00 

30.65 

500.00 

34.91 

300.00 

56.48 

280.00 

58.98 

180.00 

75.00 

160.00 

78.70 

110.00 

89 . 17 

100.00 

91.02 

65 . 00 

95.93 

60.00 

96.39 

MAXIMUM 

MINIMUM 
DAYS  IN 

FLOW  THIS  PERIOD: 
FLOW  THIS  PERIOD: 
PERIOD: 

1080 

PERCENT 

PERCENT 

FLOW 

=  /  + 

FLOW 

=  / 

6500.00 

0.28 

6000.00 

0.28 

3600.00 

1.11 

3300.00 

1.20 

2200.00 

3.98 

2000.00 

5.28 

1300.00 

9  .72 

1200.00 

11.02 

750.00 

20.00 

700.00 

22.69 

450.00 

38.80 

400.00 

43.52 

260.00 

61.85 

240.00 

64.81 

150.00 

80 . 83 

140.00 

83.06 

90.00 

93.43 

80.00 

94.63 

55.00 

96.85 

50.00 

97.78 

7400.0 

40.0 


PERCENT  PERCENT 


FLOW 

=  / 

FLOW 

=  /  + 

5500.00 

0.28 

5000.00 

0.37 

3000.00 

1.67 

2800.00 

2.41 

1800.00 

6 .02 

1600.00 

6.85 

1100.00 

12.87 

1000.00 

14  .72 

650.00 

25.46 

600.00 

27  .78 

360.00 

47.22 

330.00 

51.76 

220.00 

67 .69 

200.00 

71.11 

130.00 

85.00 

120.00 

87 .31 

75.00 

94.91 

70.00 

95.28 

45.00 

98.89 

40.00 

100.00 

A  table  for  each  period  will  be  printed. 

At  the  end  of  the  output,  the  following  table  will  be  printed. 


********  EXCEEDENCE  FLOWS  TABLE  BY  TIME  PERIOD  ******** 
PERCENTAGES  GIVEN: 


TIME  PERIOD:  20.00 


OCT 

1 

■  DEC 

29 

750 

DEC 

30 

-  MAR 

29 

698 

MAR 

30 

'  JUN 

27 

874 

JUN 

28 

-  SEP 

25 

424 

SEP 

26 

-  SEP 

30 

322 

1.00 

60.00 

80.00100 

.00 

437  . 

27  3  . 

154  . 

40 

416  , 

299  . 

225. 

10 

642, 

493  , 

369  . 

180 

236  , 

.  151. 

95  . 

45 

244  , 

140, 

77  . 

50 

Fig.  2.7.  Sample  output  when  option  5  is  chosen  in  the  CEDUR  program 
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CHGFMT  Program 


Introduction 

The  CHGFMT  program  changes  a  USGS  format  file  to 
a  NWDC  format  file  or  vice  versa.  The  files  can  be  any 
type  of  monthly  time  series  format  that  includes  monthly 
streamflow  files  (ZMONQ). 


Running  CHGFMT 

RCHGFMT,  ZMTS,  ZMTSN 

ZMTS  =  Monthly  time  series  file  in  USGS  or 
NWDC  format;  can  be  a  multirecord  file 
(input). 

ZMTSN  =  New  monthly  time  series  file  in  NWDC 
or  USGS  format;  will  be  a  multirecord 
file  if  ZMTS  is  (output). 
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DAILY  Program 


Introduction 

The  DAILY  program  generates  a  Mean  daily  streamflow 
values  request  file  to  retrieve  data  from  the  WATSTORE 
data  base. 

Before  running  DAILY,  you  must  have  obtained  the 
WATSTORE  message  file  and  processed  the  message  file 
using  the  GETREL  program.  The  MESS  program  gener¬ 
ates  a  WATSTORE  message  request  file  to  retrieve  the 
data  from  the  WATSTORE  data  base. 

Running  DAILY 

RD AILY,  REELNO,  WATREQ 


Enter  PUN  if  you  want  to  use  the  data  as  input  to  other 
programs.  The  data  will  be  written  in  USGS  format.  When 
the  punched  format  is  requested,  some  printed  information 
will  be  written  to  the  top  of  the  output  file.  After  reviewing 
this  information,  delete  it  up  to  the  header  line  (line  starting 
with  H).  This  file  is  then  a  daily  streamflow  file  (ZDQ). 

Ent^r  an  6  digit  STATION  NtJMBER 

Enter  the  2  letter  STANDARD  ABBREVIATION  for  the  State 
for  vhich  this  etation.  is  located, 

(Eor  a  code  listing,  enter  ZZ) 

Enter  additional  STATION  NUMBERS  (maxiimiin  of  4) 

(all  MUST  be  in  the  same  State  as  the  first  station) . 

Terminate  with  a  0  (zero) 

Enter  dates  of  intereet  at  the  foilowingr  prompts. 

If  the  entire  record  is  of  interest,  leave  dates  blank. 

Enter  FIRST  YEAR  and  MONTH  tyyyymml  .r^ . 

Enter  LAST  YEAR  and  MONTH  (yyyyrom?  _ 


REELNO  =  File  of  tape  reel  numbers  from  the  daily 
values  backfile  (input).  This  file  was  cre¬ 
ated  by  the  GETREL  program. 

WATREQ  “  WATSTORE  request  file  to  obtain  mean 
daily  streamflow  values  (output). 


Your  responses  to  the  following  questions  should  all 
be  in  UPPER  CASE.  Set  the  <Caps  Lock>  key  active. 


Enter  your  USER  ID  (7  alphanumeric  characters) 

Enter  your  ACCOUNT  NUMBER  (9  digits) 

Enter  a  5  letter  AGENCY  ABBREVIATION  and  your 
3  INITIALS/  separated  by  a  comma  and  IN  QUOTES 
(for  example,  ^USFWS.CLL*)  _ 

Do  not  forget  to  enter  the  quotes  and  comma! 


JOBi  PRIORITY  LEVELS  .determine  how  fast  a  job  executes?.: 


A  -  30  MINUTES 
B  -  2  HOURS 
C  -  5  HOURS 
E  -  24  HOURS 
G  “99  HOURS 


3X  BILLING  FACTOR 
2X  BILLING  FACTOR 
IX  BILLING  FACTOR 
.6X  BILLING  FACTOR 
.3X  BILLING  FACTOR 


What  PRIORITY  LEVEL  will  this  job  have2 


The  higher  the  priority  level,  the  more 

expensive  the  job 

is  to  run. 

Do  you  .want  the  DAILY  values  converted  to  MONTHLY 
values,  thus  obtaining  12  values  per  water  year 
instead  of  36B?  (Y/N) 

The  output  is  the  same  when  PUNched  output  is  re¬ 
quested.  Tlie  DQTOMQ  program  could  be  run  to  convert 
the  daily  streamflow  file  to  a  monthly  streamflow  file. 


a  po  you  want  PRIntedib  output?  (PRI/PUN) :  ^ 

Enter  PRI  if  you  are  only  interested  in  reviewing  the  data 
and  not  using  it  as  input  to  other  programs. 


Years  are  in  water  years — that  is,  October  is  month  1  and 
September  is  month  12. 


The  xeKjuest  file  you  have  created  is  (the  name  specified 
when  the  program  was  invoked  will  be  displayed  here]  ,  . 

Tr ans f  er : thi e  f 1 le  to  the  AMDAHL  : computer  in- Res tonvwVA  using- 
a  mictocomputer  communications  software  package. _ 


If  you  receive  this  message,  you  have  probably  success¬ 
fully  created  the  DAILY  request  job.  Figure  2.8  is  a  sample 
Daily  request  job. 

Things  to  check: 

•  Are  all  characters  in  upper  case? 

•  Are  the  correct  user  ID  and  accoimt  number  entered 
on  line  1? 


//USERID#  JOB  (ACCOUNT#,H475,10,20,3000) , 'USFWS.MAU' , 
//  CLASS=E,MSGLEVEL= (2, 0) 

/♦ROUTE  PRINT  RMT240 
/♦ROUTE  PUNCH  RMT240 

//PROCLIB  DD  DSN«WRD.PROCLIB,DISP=SHR 

/♦SETUP  561575/H 

//SI  EXEC  PGM=IEBGENER 

//SYSPRINT  DD  SYSOUT=A 

//SYSUT2  DD  SYSOUT=A,DCB=BLKSIZE=80 

//SYSIN  DD  DUMMY 

//SYSUTl  DD  ♦ 

/* 

//S2  EXEC  PGM=IEBGENER 
//SYSPRINT  DD  SYSOUT=A 
//SYSUT2  DD  SYSOUT=B 
//SYSIN  DD  DUMMY 
//SYSUTl  DD  * 

/* 

//S3  EXEC  DVRETR,AGENCY=USGS,V0L1«561575 
//HDR. SYSIN  DD  ♦ 

M3  XX 

R00060 

F00003 

P999999 

Q999999 

D  02433500 

/* 

// 


Fig.  2.8.  Sample  DAILY  request  job. 
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•  Are  there  quotes  around  your  agency  and  initials  and 
are  they  separated  with  a  comma  (line  1)? 

•  Did  you  specify  the  job  priority  level  (CLASS=)  that 
you  desire  on  line  2? 

•  Is  there  a  6-digit  number  before  the  last  slash  on  the 
/*SETUP  line? 

•  Is  there  an  8-digit  station  number  on  the  D  line(s)? 

•  Does  the  second  to  the  last  line  contain  the  characters 

/*? 

•  Does  the  last  line  contain  the  characters  //? 

If  any  items  are  missing  or  incorrect,  the  job  will  not  run. 
You  may  correct  simple  errors  such  as  user  ID  and  account 
number  with  an  editor.  If  other  errors  are  identified,  it  is 


recommended  that  DAILY  be  run  again  and  the  file 
recreated. 

The  Mean  daily  stieamflow  values  request  file  is  now 
ready  to  be  uploaded  to  the  AMDAHL  mainframe  com¬ 
puter  in  Reston,  Virginia,  using  a  microcomputer  commu¬ 
nications  package.  Refer  to  Appendix  G  for  instructions 
for  logging  on  to  the  AMDAHL  computer,  submitting  jobs 
for  processing,  and  recovering  output  from  the  WYLBUR 
Fetch  Queue. 

Before  printing  information  obtained  from  WATSTORE 
using  a  request  file  created  by  DAILY,  the  PAGEBR  pro¬ 
gram  could  be  run  on  the  WATSTORE  output  file  to  insert 
a  printer  control  character  at  points  where  printing  should 
begin  on  a  new  page. 


22 


BiolcxjIcal  Report  90  (16) 


DQFY  Program 


Introduction 

The  DQFY  program  removes  incomplete  years  from  a 
daily  streamflow  file  in  WATSTORE  format  for  use  with 
the  CEDUR,  DQTOMQ,  and  HABTD  programs;  DQFY 
also  removes  excess  title  lines.  Files  from  Hydrodata  con¬ 
tain  extra  title  lines.  Therefore  they  need  to  be  run  through 
the  DQFY  program  before  they  can  be  used  as  input  to  the 
TSLIB  programs. 

Daily  streamflow  files  from  WATSTORE  may  contain 
data  from  at  least  one  gaging  station  for  one  to  several 
years;  data  for  one  gaging  station  constitutes  one  set  of 
data.  Before  running  the  CEDUR,  DQTOMQ,  and 
HABTD  programs,  the  DQFY  program  should  be  run  on 
the  daily  streamflow  file  to  ensure  that  only  complete  years 
are  included  and  that  there  are  only  two  title  lines  in  the 


file  (the  CEDUR,  DQTOMQ,  and  HABTD  programs  will 
only  accept  two  title  lines).  Title  lines  begin  with  H,  N,  or 
Y  in  column  1.  (Lines  with  the  string  ENT  beginning  in 
column  55  indicate  the  beginning  of  yearly  data  and  are 
not  title  lines). 

Running  DQFY 

RDQFY,ZDQ,ZDQN 

ZDQ  =  Daily  streamflow  file  in  WATSTORE 
format  (input). 

ZDQN  =  New  daily  streamflow  file  in  WAT¬ 
STORE  format  with  complete  years  and 
two  title  lines  (output). 
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DQTOMQ  Program 


Introduction 

The  DQTOMQ  program  reads  a  daily  streamflow  file  in 
WATSTORE  format  and  writes  a  monthly  streamflow  file 
in  NWDC  format. 

Daily  streamflow  files  fiom  WATSTORE  may  contain 
data  from  at  least  one  gaging  station  for  one  to  several 
years;  data  for  one  gaging  station  constitutes  a  set  of  data. 
Before  running  DQTOMQ,  the  DQFY  program  should  be 
run  on  the  daily  streamflow  file  to  ensure  that  only  com¬ 
plete  years  are  included,  and  that  there  are  only  two  title 
lines  in  the  file  (the  DQTOMQ  program  will  only  accept 
two  title  lines).  Title  lines  begin  with  H,  N,  or  Y  in 
column  1.  (Lines  with  the  string  ENT  beginning  in  col¬ 


umn  55  indicate  the  beginning  of  yearly  data  and  are  not 
title  lines). 

Running  DQTOMQ 

RDQTOMQ,  ZDQ,  ZMONQ 

ZDQ  =  Daily  streamflow  file  in  WATSTORE 
format  (input).  This  file  must  have  been 
run  through  DQFY  to  remove  incom¬ 
plete  years  and  excess  title  lines. 

ZMONQ  =  Monthly  streamflow  file  in  NWDC  for¬ 
mat  (output). 
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DURTBL  Program 


Introduction 


Years  are  in  water  years — that  is,  October  is  month  1  and 
September  is  month  12. 


The  DUKTBL  program  generates  a  Daily  streamflow 
values  duration  table  request  file  to  retrieve  data  from  the 
WATSTORE  data  base.  The  retrieved  data  can  be  used  as 
input  to  the  DQDUR  program  (Chapter  6). 

Before  running  DURTBL,  you  must  have  obtained  the 
WATSTORE  message  file  and  processed  the  message  file 
through  the  GETREL  program.  The  MESS  program  gem 
erates  a  WATSTORE  message  request  file  to  retrieve  the 
data  from  the  WATSTORE  data  base. 


Running  DURTBL 

RDTJRTBL,  REELNO^  WATREQ 

REELNO  =  File  of  tape  reel  numbers  from  the  daily 
values  backfile  (input).  This  file  was  cre¬ 
ated  by  the  GETREL  program. 

WATREQ  =  WATSTORE  request  file  to  obtain  daily 
streamflow  values  duration  table  (out¬ 
put). 


Your  responses  to  the  following  questions  should  all 
be  in  UPPER  CASE.  Set  the  <Caps  Lock>  key  active. 


Enter  your  USER  ID  (7  alphanumeric  characters) 

Enter  yOur  ACCOUNT  NUMBER  (9  digits)  -> 

Enter  a  5  letter  AGENCY  ABBREViATIcaj.  and 
3  INITIALS/  separated  by  a  comma  and  IN  jJUOTES 
(for  example,  *USFNS,CLLM 


Do  not  forget  to  enter  the  quotes  and  comma! 


JOB  PRIORITY  LEVELS  determinevhow  fast  a  job  executes  5  $ 


-30  MINUTES 

-  2  HOURS 

-  5  HOURS 

-  24  HOURS 
-99  HOURS 


3X  BILLING  FACTOR 
2X  BILLING  FACTOR 
IX  BILLING  FACTOR 
.6X  BILLING  FACTOR 
.3X  BILLING  FACTOR 


What  PRIORITY  LEVEL  will  this  job  have?  -» 


The  higher  the  PRIORITY  LEVEL,  the  more  expensive 
the  job  is  to  run. 


Enter  an  8  digit  STATION  NIWBER  -> 

in^erj.the  2  letter  STANDARD  ABBjt^IATION  fox  the  State 
for'-' which  this  station  is  ioca tied ■.:••• 

{For  a  code  listing^  enter  ZZ)  -> 

Enter  additional  STATION  NUMBERS  (maximum  of  4) 

(all  MUST  be  in  the  same  State  as  -the  first  station) > 
Terminate  with,  a  0  (zero) 

Enter  dates  of  interest  at  the  following  prompts. 

If  the  entire  record  is  of  interest,  leave  year  blank, 

Enter  FIRST  YEAR  (yyyy) 

j  :=Enter  LAST -  YEAR  Cyyyy)  -»  '=  ■  ■■  ' 


The  request  file  you  have  created  is  (the  name  specified 
when  the  program  Was  invoked  will  be  displayed  hete) - 
Transfer  this  file  to  the  AMDAHL  computer  in  Reston,  VA 
Using  a  microcomputer  Communications  software  package. 


If  you  receive  this  message,  you  have  probably  success¬ 
fully  created  the  DURTBL  request  job.  Figure  2.9  is  a 
sample  DURTBL  request  job. 

Things  to  check: 

•  Are  all  characters  in  upper  case? 

•  Are  the  correct  user  ID  and  account  number  entered 
on  line  1? 

•  Are  there  quotes  around  your  agency  and  initials  and 
are  they  separated  with  a  comma  (line  1)7 

•  Did  you  specify  the  job  priority  level  (CLASS=)  that 
you  desire  on  line  2? 

•  Is  there  a  6-digit  number  before  the  last  slash  on  the 
/*SETUP  line? 

•  Is  there  an  8-digit  station  number  on  the  D  line(s)? 

•  Does  the  last  line  contain  the  characters  //? 

If  any  items  are  missing  or  incorrect,  the  job  will  not  run. 
You  may  correct  simple  errors  such  as  user  ID  and  account 
number  with  an  editor.  If  other  errors  are  identified,  it  is 
recommended  that  DURTBL  be  run  again  and  the  file 
recreated. 

The  Daily  streamflow  values  duration  table  request  file 
is  now  ready  to  be  uploaded  to  the  Amdahl  mainframe 


//ABCD123  JOB  (1234567 89 /A969 , 10 , 20 , 3000) USFWS , MAU' , 
//  CLASSIC, MSGLEVEL= (2, 0) 

/*ROUTE  PRINT  RMT240 
/♦ROUTE  PUNCH  RMT240 

//PROCLIB  DD  DSN=WRD.PROCLIB,DISP=SHR 

/♦SETUP  561588/H 

//SI  EXEC  PGM=IEBGENER 

//SYSPRINT  DD  SYSOUT=A 

//SYSUT2  DD  SYSOUT=A,DCB'BLKSIZE=80 

//SYS IN  DD  DUMMY 

//SYSUTl  DD  ♦ 

/* 

//S2  EXEC  DVRETR,AGENCY=USGS,V0L1=561588 
//HDR.SYSIN  DD  * 

M3 

XA969  MAIN0006000003  XX  X 

XA969  MONA  010203040506070809101112 

R00060 

F00003 

P999999 

Q999999 

D  12142000 

/* 

//S3  EXEC  DVSTAT 
// 

Fig.  2.9.  Sample  DURTBL  request  job. 
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computer  in  Reston,  Virginia,  using  a  microcomputer 
communications  package.  Refer  to  Appendix  G  for  in¬ 
structions  for  logging  on  to  the  Amdahl  computer,  submit¬ 
ting  jobs  for  processing,  and  recovering  output  from  the 
WYLBUR  Fetch  Queue. 


Before  printing  information  obtained  from  WATSTORE 
using  a  request  file  created  by  DURTBL,  the  PAGEBR 
program  could  be  run  on  the  WATSTORE  output  file  to 
insert  a  printer  control  character  at  points  where  printing 
should  begin  on  a  new  page. 
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GETREL  Program 


Introduction 

The  GETREL  program  processes  the  WATSTORE  mes¬ 
sage  file  (obtained  by  submitting  the  request  file  generated 
by  the  MESS  program)  and  generates  a  file  of  tape  reel 
numbers  from  the  daily  values  backfile.  This  file  is  used 
by  the  DAILY,  DURTBL,  and  INVENT  programs  when 
generating  a  request  job  from  WATSTORE. 

GETREL  reads  the  WATSTORE  message  file  and  ex¬ 
tracts  the  reel  numbers,  corresponding  State  codes  and 
station  numbers,  then  writes  this  information  to  a  file  in 


the  format  used  by  the  DAILY,  DURTBL,  and  INVENT 
programs. 

Running  GETREL 

RGETR£L»  WAIMESS,  REELNO 

WATMESS=  WATSTORE  message  file  (input). 

REELNO  =  File  of  tape  reel  numbers  from  the  daily 
values  backfile  (output). 


INVENT  Program 
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INVENT  Program 


Introduction 

The  INVENT  program  generates  a  station  inventory 
request  file  to  Inventory  daily  values  data  from  the  WAT- 
STORE  data  base. 

Retrieval  of  daily  values  data  for  processing  by  inven¬ 
tory  is  restricted  to  one  tape  when  generating  the  job 
request  file  using  the  INVENT  program.  This  is  not  a 
limitation  of  the  WATSTORE  programs  on  the  main¬ 
frame  but  of  the  program  that  generates  the  job  request 
file.  The  daily  values  retrieval  program  can  accommo¬ 
date  two  input  tapes  during  the  same  job,  so  the  more 
experienced  user  could  modify  the  job  request  files  gen¬ 
erated  by  the  programs  to  use  two  input  tapes.  To  avoid 
errors  with  the  input  tapes,  the  retrievals  are  restricted  to 
one  State  per  job.  Again,  this  is  a  limitation  of  the 
programs  and  not  WATSTORE. 

There  are  three  station  selection  methods  available. 
Two  methods  involve  the  specification  of  station  ID’s — 
individual  stations  and  a  range  of  stations.  The  third 
method  is  a  polygon  retrieval  where  stations  are  retrieved 
according  to  the  boundaries  of  the  polygon.  The  polygon 
generated  by  INVENT  contains  four  latitude-longitude 
vertices  that  are  created  by  two  vertices  entered  by  the 
user.  When  using  the  polygon  retrieval,  a  special  agency 
identification  code  may  be  specified,  ALLAG,  which 
retrieves  data  for  all  stations  in  a  given  area  regardless 
of  the  agencies  operating  the  stations.  Any  agency  may 
or  may  not  have  data  in  the  WATSTORE  data  base  for 
any  given  location.  Presently,  three  States  (California, 
Rorida,  and  Texas)  have  daily  values  data  stored  on  more 
than  one  tape.  This  forces  the  station  selection  method 
used  to  be  either  individual  stations  or  a  station  range, 
because  using  a  station  ID,  in  addition  to  State  code,  is 
the  only  way  of  determining  the  proper  tape  when  mul¬ 
tiple  tapes  are  involved. 

When  an  inventory  of  a  station  is  performed,  all  daily 
values  are  processed;  therefore,  inventory  of  stations  can 
be  expensive.  Care  should  be  taken  when  using  the 
station  selection  method  of  polygon  because  of  the  num¬ 
ber  of  stations  that  may  be  processed.  The  cost  of  a  single 
job  using  this  station  selection  method  could  easily  ex¬ 
ceed  $15.00,  depending  on  the  size  and  location. 

To  use  INVENT,  you  need  to  know  the  station  selection 
method  of  the  sites  you  are  interested  in,  the  station 
numbers  or  latitude-longitude  vertices  for  station  iden¬ 
tification,  and  the  State  in  which  the  stations  are  located. 


Running  INVENT 

RIN  VENT,  REELNO,  WATREQ 

REELNO  *  File  of  tape  reel  nximbers  from  the  daily 
values  backfile  (input).  This  file  was  cre¬ 
ated  by  the  GETREL  program. 

WATREQ  =  WATSTORE  request  file  to  inventory 
daily  values  data  (output). 


Your  responses  to  the  following  questions  should  all 
be  in  UPPER  CASE.  Set  the  <Caps  Lock>  key  active. 


Enter  your  USER  ID  {7  alphanumeric  character^} 

Enter  your  ACCOUNT  NUMBER  (9  digits) 

Enter  a  5  letter  AGENCY  ABBREVJATIOM  and  your 
3  INITIALS,  separated  by  a  comma  and  IN  QUOTES 
(for  example,  *usfws,CLLM  _ 


Do  not  forget  to  enter  the  quotes  and  comma! 

JOB  PRIORITY  LEVELS  determine  how  fast  a  job  executesit 

A  ~  30  MINUTES  3X  BILLING  FACTOR 

B  “*  2  HOURS  2X  BILLING  FACTOR 

C  -  5  HOURS  IX  BILLING  FACTOR 

E  -  24  HOURS  >6X  BILLING  FACTOR 

0-99  HOURS  .3X  BILLING  FACTOR 

What  PRIORITY  LEVEL  vill  thig  job  have?  _ 


The  higher  the  priority  level,  the  more  expensive  the 
job  is  to  run. 

Choose  a  Station.  Selection  Method. 

1  "^Individual  Stations  .(maximum  of  10)/ 

2  -  Station  Range  (Station  ID  thru  Station  ID) , 

3  -  Regional  (Polygon) ♦ 

Enter  choice 


See  discussion  of  these  methods  in  the  INVENT  “In¬ 
troduction”  section. 

Users  will  be  prompted  for  station  numbers  after  the 
State  prompt  (immediately  following)  is  answered.  All 
station  numbers  must  be  from  the  same  State.  Beginning 
station  numbers  must  be  less  than  the  ending  station 
numbers. 


Enter  the  2  letter  STANDARD  ABBREVIATION  for  the  State 
in  which  thia  station  is  located. 

(For  a  code  listing,  enter  2,2) 

The  request  file  you  have  created  is  (the  name  specified 
when  the  program  was  invoked  will  be  displayed  here) . 
i.Txansfer  this  file  to  the  AMDAHL  computer  in  Reeton,  VA 
using  a  microcomputer  communications  software  package. _ 

If  you  receive  this  message,  you  have  probably  suc¬ 
cessfully  created  the  INVENT  request  job.  Figure  2.10 
is  a  sample  INVENT  request  job. 
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//ABCD123  JOB  ( 1234567 89 , H47 5 , 10 , 20 , 3000) , ' USFWS, CLL' , 
//  CLASS =C,MSGLEVEL= 2,0) 

/* ROUTE  PRINT  RMT240 
/* ROUTE  PUNCH  RMT240 

//PROCLIB  DD  DSN=WRD.PROCLIB,DISP=SHR 

/♦SETUP  115614/H 

//SI  EXEC  PGM'IEBGENER 

//SYSPRINT  DD  SYOUT=A 

//SYSUT2  DD  SYSOUT=A,DCB=BLKSIZE=80 

//SYSIN  DD  DUMMY 

//SYSUTl  DD  * 

/* 

//S2  EXEC  DVRETR, AGENCY=USGS,V0L1=115614 


//HDR. SYSIN  DD  * 

M3 

XH483 

S  06017012 

10523000 

/* 

//S3  EXEC  DVLISTA 
/* 

// 

Fig,  2.10.  Sample  INVENT  request  job. 


Things  to  check: 

•  Are  all  characters  in  upper  case? 

•  Are  the  correct  user  ID  and  account  number  entered 
online  1? 

•  Are  there  quotes  around  your  agency  and  initials  and 
are  they  separated  with  a  comma  (line  1)7 

•  Did  you  specify  the  job  priority  level  (CLASS=)  that 
you  desire  on  line  2? 

•  Check  the  8-digit  station  number(s)  on  the  line(s) 
following  line  XH483  if  station  selection  method  1 
or  2  (individual  or  range)  was  chosen,  or  the  13-digit 
latitude-longitude  vertices  if  station  selection  3  (re¬ 
gional)  was  chosen. 

•  Is  there  a  6-digit  number  before  the  last  slash  on  the 
/*SETUPline? 

•  Does  the  second  to  the  last  line  contain  the  characters 
/*? 

•  Does  the  last  line  contain  the  characters  //? 

If  any  of  these  items  are  missing  or  incorrect,  the  job  will 
not  rim.  You  may  correct  simple  errors,  such  as  user  ID  and 
account  number,  with  an  editor.  If  other  errors  are  identi¬ 
fied,  it  is  recommended  that  INVENT  be  run  again  and  the 
file  recreated. 

The  Inventory  of  stations  request  file  is  now  ready  to  be 
uploaded  to  the  Amdahl  mainframe  computer  in  Reston, 
Virginia,  using  a  microcomputer  communications  pack¬ 
age.  Refer  to  Appendix  G  for  instructions  for  logging  on 
to  the  Amdahl  computer,  submitting  jobs  for  processing, 
and  recovering  output  from  the  WYLBUR  Fetch  Queue. 

Before  printing  out  information  obtained  from 
WATSTORE  using  a  request  file  created  by  INVENT,  the 
PAGEBR  program  could  be  run  on  the  WATSTORE  out¬ 
put  file  to  insert  a  printer  control  character  at  points  where 
printing  should  begin  on  a  new  page. 


Interpreting  Information 
Provided  by  Inventory 

There  are  only  two  items  that  need  any  explanation,  and 
those  items  are  under  the  column  headings  FARM  CODE 
and  STAT  CODE.  The  daily  values  file  parameter  codes 
(FARM  CODE)  uniquely  identify  each  parameter  avail¬ 
able  for  a  specific  site.  The  statistic  codes  (STAT  CODE) 
identify  each  set  of  daily  or  instantaneous  data  available 
as  to  frequency  of  measurement  or  statistical  reduction  of 
the  data. 

Modifications  to  the  parameter  code  list  are  expected  to 
be  quite  high;  therefore,  WATSTORE  users  are  recom¬ 
mended  to  periodically  obtain  a  list  by  submitting  the 
following  job  (substituting  the  appropriate  user  ID  and 
account  number  in  the  first  line): 

//USERID#  JOB  ( 123456789, WMSG) , 'USFWS, ARM' ,CLASS=C 

/•ROUTE  PRINT  RMT240 

//PROCLIB  DD  DSN=WRD. PROCLIB, DISP*SHR 

//  EXEC  LPARM 

//SORTLIB  DD  DU104Y 

/* 

// 


After  submitting  this  job,  retrieve  it  as  you  would  any 
other  WATSTORE  data  or  information. 

To  retrieve  daily  values  using  specific  parameters  and 
statistic  codes,  you  must  alter  the  parameter  (R)  and  sta¬ 
tistic  (F)  lines  within  a  daily  values  request  file.  First, 
create  a  request  file  using  the  DAILY  program  then  use  an 
ASCII  editor  to  change  the  R  and  F  lines  as  desired.  The 
formats  of  the  lines  are  given  below. 

Parameter  {R)Lim,Asv[miy2&  15  parameter  codes  may 
be  specified  on  the  R  line,  beginning  in  the  left-most  field. 
This  line  only  needs  to  be  coded  if  the  retrieval  is  to  be 
restricted  to  a  given  set  of  parameter  codes.  If  the  R  line  is 
not  present,  daily  values  data  for  all  parameters  will  be 
retrieved.  Specifying  the  parameters  to  limit  the  amount  of 
data  retrieved  to  what  is  actually  needed  is  recommended. 


Col.  1 

Col.  2-6, 7-11, 
12-16, 17-21, 
22-26, 27-31, 
32-36,  37^1, 
42^6,  47-51, 
52-56, 57-61, 
62^,  67-71, 
72-76 
Col.  77-78 
Col.  79-80 


Enter  an  R 

Enter  5-digit  parameter  code(s). 
Obtained  by  submitting  above  file. 


Blank 

Retrieval  identifier  (may  be  left  blank) 


Statistic  (F)  Line,  As  many  as  15  statistic  codes  may  be 
specified  on  the  F  line,  beginning  in  the  left-most  field. 
This  line  need  be  coded  only  if  the  retrieval  is  to  be 
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restricted  to  a  given  set  of  statistic  codes.  If  the  F  line  is 

00005 

PM  (sample  taken  between 

not  present,  statistic  codes  will  not  be  considered  in  select¬ 

1200-2400  hours) 

ing  daily  values  records  for  retrieval. 

00006 

Sum 

00007 

Mode 

Col.  1 

Enter  an  F 

00008 

Median 

Col.  2-6, 7-11, 

Enter  5-digit  statistic  code(s). 

00009 

Standard  deviation 

12-16, 17-21, 

See  statistic  code  list. 

00010 

Variance 

22-26,  27-31, 

00011 

Random  instantaneous 

32-36,  37-41, 

00012 

Equivalent  mean^ 

42-46, 47-51, 

00013 

Skewness 

52-56, 57-61, 

00014-00020 

Reserved  for  future  use 

62-66,  67-71, 

00021 

Tidal  high  (Daily) 

72-76 

00022 

Tidal  low-high  (Daily) 

Col.  77-78 

Blank 

00023 

Tidal  high^ow  (Daily) 

Col.  79-80 

Retrieval  identifier  (may  be  left  blank) 

00024 

Tidal  low  (Daily) 

00025-00999 

Reserved  for  future  use 

Statistic  Code  List 

Code 

Statistic 

^  When  used  in  combination  with  parameter  72019  (distance  below  LSD), 

the  maximum  value  for  this  parameter  will  be  the  minimum  elevation. 

00001 

Maximum^ 

and  the  minimum 

value  for  this  parameter  will  be  the  maTimiim 

00002 

Minimum^ 

elevation. 

00003 

Mean 

^  Commonly  used  with  gage-height  (parameter  code  00065)  values  that 

00004 

AM  (sample  taken  between 

0000-1200  hours) 

represent  an  equivalent  mean  that  corresponds  to  the  calculated  mean 
discharges  (parameter  code  00060). 

30 


Biological  Report  90  (16) 


LSTDQ  Program 


Introduction 

The  LSTEK3  program  writes  a  file  containing  header 
information  and  title  lines  or  information  by  water  years 
in  a  daily  streamflow  file.  WATSTORE  files  may  contain 
several  data  sets  (data  from  different  gaging  stations)  with 
individual  title  lines. 

When  information  is  listed  by  water  years,  the  first  two 
lines  of  the  file  and  one  water  year  of  data  are  listed  on 
each  page,  as  opposed  to  all  the  years  being  run  together 
and  separated  by  the  string  ENT  in  column  55. 

If  the  input  file  has  other  than  two  lines  above  the  first 
ENT  string,  these  lines  will  be  listed  on  the  first  page  of 
the  output.  If  this  information  is  not  desired  in  the  LSTDQ 
output,  remove  the  excess  lines  with  an  editor  before 
running  LSTDQ. 


Running  LSTDQ 

RLSTDQ,ZDQ,ZOUr 

ZDQ  *  Daily  streamflow  file  in  WATSTORE 
format  (input). 

ZOUT  =  LSTDQ  results  (output).  If  filename  is 
not  specified  and  only  headings  are  re^ 
quested,  output  will  go  to  the  screen. 

BrrrER  o  to  list  headers  OHLY  — ™ 

_ 1  TQ  LIST  INFORMATIOH 


Figure  2.11  contains  sample  output  from  the  LSTDQ 
program. 


LSTDQ  Program 


TIME  -  16.12.00. 


PROGRAM  -  LSTDQ 


SET  1 

12142000  4736541214244005353033SW17110010  64.00  1130.00 

12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

12142000  0006000003  ENT 

12142000  19700101  225.00  209.00  200.00  183.00  168.00  166.00  164.00  156.00 


N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 


STATION  ID.  -  12142000 

DRAINAGE  AREA  -  64.00 

PERCENT  CONTRIBUTING  -  100.00 
LATITUDE  -  47  36  54 
LONGITUDE  -  121  42  44 
STATE  -  53 
COUNTY  -  33 
SITE  -  SW 

HYDROLOGIC  UNIT  -  17110010 
DATUM  -  1130.00 


ption  1  (List  Information  by  Yeare) i 


PROGRAM  -  LSTDQ 


DATE  •  88/11/28 


TIME  -  15.57.49. 


H  12142000  4736541214244005353033SW17110010  64.00  1130.00 

N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 
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12142000  0006000003  ENT 

3  12142000  19701001  138.00  129.00  120.00  116.00  431.00  324.00  230.00  205.00 

3  12142000  197010021370.00  766.00  456.00  496.00  362.00  288.00  248.00  218.00 

3  12142000  19701003  198.00  205.00  312.00  362.00  468.00  468.00  710.00  740.00 

3  12142000  19701004  444.00  330.00  273.00  245.00  222.00  209.00  196.00 

3  12142000  19701101  187.00  183.00  172.00  158.00  152.00  183.00  172.00  270.00 

3  12142000  19701102  448.00  297.00  365.001260.00  700.00  424.00  386.001020.00 

3  12142000  19701103  620.00  715.00  720.00  665.00  456.00  348.001310.003090.00 

3  12142000  197011041140.00  665.00  508.00  400.00  340.00  312.00 

3  12142000  19701201  282.00  260.00  240.00  225.00  592.002550.002330.00  975.00 

3  12142000  19701202  606.00  588.00  700.00  476.00  393.00  348.00  351.00  350.00 

3  12142000  19701203  310.00  266.00  250.00  230.00  210.00  200.00  190.00  177.00 

3  12142000  19701204  165.00  165.00  165.00  180.00  260.00  400.00  450.00 

3  12142000  19710101  260.00  220.00  196.00  178.00  169.00  158.00  172.00  500.00 

3  12142000  197101021270.00  960.00  600.00  382.00  315.00  273.00  394.00  814.00 

3  12142000  197101031030.001070.004050.001380.00  796.00  675.001310.001380.00 

3  12142000  197101041020.002380.001550.00  916.00  680.001580.002390.00 

3  12142000  197102011380.00  947.00  705.00  588.00  480.00  412.00  372.00  340.00 

3  12142000  19710202  358.001970.001740.001310.002270.001770.001930.001080.00 

3  12142000  19710203  740.00  640.00  530.00  460.00  440.00  420.00  405.00  580.00 

3  12142000  19710204  460.00  380.00  340.00  308.00 

3  12142000  19710301  282.00  280.00  270.00  250.00  235.00  220.00  320.00  300.00 

3  12142000  19710302  270.00  380.00  560.00  500.00  410.00  355.00  310.00  285.00 

3  12142000  19710303  265.00  240.00  234.00  227.00  215.00  225.00  450.00  760.00 

3  12142000  19710304  500.00  450.00  410.00  380.00  920.001100.00  690.00 

3  12142000  19710401  500.00  436.00  379.00  368.00  448.00  620.00  565.00  529.00 

3  12142000  19710402  610.00  601.00  480.00  400.00  372.00  412.00  448.00  382.00 

3  12142000  19710403  330.00  306.00  288.00  324.00  327.00  300.00  300.00  309.00 

3  12142000  19710404  306.00  534.00  725.00  645.00  560.00  524.00 


Fig.  2.11.  Sample  output  from  the  LSTDQ  program. 
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MESS  Program 


Introduction 

The  MESS  program  generates  a  “WATSTORE  mes¬ 
sage”  request  file  to  retrieve  data  from  the  WATSTORE 
data  base  for  use  with  the  GETREL  program. 

All  but  the  most  recent  daily  values  data  in  the 
WATSTORE  data  base  are  stored  on  reels  of  magnetic  tape 
at  the  Reston  computer  center.  These  tape  reels  are  identi¬ 
fied  and  accessed  by  a  six-digit  tape  reel  number  assigned 
more  or  less  according  to  State.  The  tape  reel  numbers  are 
periodically  updated  when  additional  daily  values  are  ar¬ 
chived  onto  tape. 

To  maintain  a  file  of  current  and  correct  reel  numbers, 
users  of  DAILY,  DURTBL,  and  INVENT  should  peri¬ 
odically  (about  every  6  months)  submit  the  file  created 
by  the  MESS  program  on  the  Amdahl  to  obtain  the 
WATSTORE  message  file. 

Running  MESS 

RMESS,WATREQ 

WATREQ  =  Request  file  to  obtain  WATSTORE  mes¬ 
sage  file  (output). 

Your  responses  to  the  following  questions  should  all 

be  in  UPPER  CASE.  Set  the  <Caps  Lock>  key  active. 


ENTER  YOUR  7 -CHARACTER  USER  ID:  . 

ENTER  YOUR  9 -DIGIT  ACCOUNT  HUMBER;  - ; ■ 

Figure  2.12  is  a  sample  WATSTORE  message  file  re¬ 
quest  job. 

Things  to  check: 

•  Are  all  characters  in  upper  case? 

•  Are  the  correct  user  ID  and  account  number  entered 
on  line  1? 

•  Does  the  second  to  the  last  line  contain  the  characters 
/*? 

•  Does  the  last  line  contain  the  characters  //? 


If  any  items  are  missing  or  incorrect,  the  job  will  not  run. 
You  may  correct  simple  errors  such  as  user  ID  and  account 
number  with  an  editor.  If  other  errors  are  identified,  it  is 
recommended  that  MESS  be  run  again  and  the  file 
recreated. 

The  “WATSTORE  message”  request  file  is  now  ready 
to  be  uploaded  to  the  Amdahl  mainframe  computer  in 
Reston,  Virginia,  using  a  microcomputer  communications 
package.  Refer  to  Appendix  G  for  instructions  for  logging 
on  to  the  Amdahl  computer,  submitting  jobs  for  process¬ 
ing,  and  recovering  output  from  the  WYLBUR  Fetch 
Queue. 

For  the  more  advanced  user,  the  cost  of  downloading  the 
entire  message  file  can  be  reduced  by  downloading  the 
specific  section  of  importance.  An  example  of  the  section 
is  given  here  so  that  you  may  identify  it.  If  you  are  not 
familiar  enough  with  using  the  WYLBUR  system  to  locate 
and  display  this  portion  of  the  message,  it  is  recommended 
that  the  entire  file  be  downloaded  to  avoid  confusion. 


WATSTORE  DAILY  VALUES  BACKFILE  (6250  BPI)  TAPE- 
FEBRUARY  22,  1990 


TAPE 

NO 

BEGINNING 

STATE 

CODE 

ENDING 

STATE 

CODE 

STATE 

ABBREV 

561560 

01 

02 

AL,  AK 

561561 

04 

05 

AZ,  AR 

561562 

06 

06  (11147070) 

CA 

561563 

06(11147500) 

06  (11381990) 

CA 

561564 

06  (11382000) 

06 

CA 

Sample  terminated  here  for  brevity. 

****★***★★■**★***★**★★******★**★********★* 
DAILY  VALUE  BACKFILE  TAPE  USERS  ARE  RE¬ 
MINDED  THAT  TAPES  MUST  BE  USED  BY  THE 
ORDER  OF  STATE  CODES  AND  NOT  NUMERICALLY. 

***************************************** 


//1234567  JOB  (999999999 ,WMSG) , 'MESSAGE  ',CLASS=C 
//* 

//*  THIS  JOB  PRINTS  LISTINGS  OF  BACKFILE  TAPES 
//* 

/•ROUTE  PRINT  RMT240 

//PROCLIB  DD  DSN=WRD.PROCLIB,DISP=SHR 
//MSG  EXEC  MESSAGE,WRDMSG='WRD02' 

/* 

// 


Note:  If  there  are  colons  at  the  beginning  of  each  line, 
remove  them  (replace  colons  with  blanks)  so 
that  the  GETREL  program  will  run  correctly. 
Another  way  to  remove  the  colons  would  be  to 
see  if  your  communications  software  has  a 
STRIP  CHARACTERS  function.  K  it  does,  set 
this  function  in  the  communications  parameters 
and  resubmit  the  message  request  file. 


Fig.  2.12.  Sample  WATSTORE  message  file  request  job. 
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PAGEBR  Program 


Introduction 

The  PAGEBR  program  prepares  a  WATSTORE  output 
file  (generated  using  the  request  file  created  by  DAILY, 
DUKTBL,  INVENX  or  the  PEAK  program)  for  printing. 
PAGEBR  inserts  a  printer  control  character  at  points  where 
printing  should  begin  on  a  new  page.  The  page  breaks  are 
determined  by  key  phrases  in  specific  positions — these  are 
known  as  headers.  In  the  absence  of  a  header,  a  control 
character  is  inserted  every  60  lines. 

Depending  on  the  type  of  information  requested  from 
WATSTORE,  there  is  limited  editing  necessary  on  the 
output  file  generated  before  the  data  is  used,  either  as  input 
for  a  program  such  as  PAGEBR  or  printed  for  reference  or 
publication.  Any  ASCII  editor  may  be  used.  The 
WATSTORE  processing  information  precedes  the  data.  In 


most  cases,  you  will  want  to  remove  this  portion  of  the 
output.  The  importance  of  this  information  is  to  verify  the 
parameters  and  controls  used  in  the  retrieval,  and  messages 
such  as  invalid  station  numbers  and  dates.  At  the  end  of 
the  retrieved  file,  there  may  be  lines  that  should  be  re¬ 
moved.  The  lines  to  remove  include  the  line  containing 
COMMAND?  through  the  end  of  the  file. 

Running  PAGEBR 

RPAGEBR,ZIN,ZOUT 

ZIN  =  WATSTORE  output  file  (input). 

ZOUT  *  WATSTORE  output  file  with  page 
breaks  (output). 
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PEAK  Program 


Introduction 


The  PEAK  program  generates  a  Peak  streamflow  values 
request  file  to  retrieve  data  from  the  WATSTORE  data 
base. 


Running  PEAK 


RPEAK,WATREQ 


WATREQ  “  WATSTORE  request  file  to  obtain  peak 
streamflow  values  (output). 


Your  responses  to  the  following  questions  should  all  be 
in  UPPER  CASE.  Set  the  <Caps  Lock>  key  active. 


enter  you?  OSJSl^  10  O  alphanuroerio  ohataocara)  *4 

Entai  y«yur  hCCOKm  miHSER  i9  digits) 

enter  ft  5  lette*  AOSHCV  ABBREViATiott  and  your 
3  miTlAtiS,  eepatftted  l^y  ft  coowa  and  IN  QUOTES 
<lor  exag^lft>  ^USFWS.ceL*)  _ 


Do  not  forget  to  enter  the  quotes  and  comma! 


JOB  PRIOBITV  t.EVEt.S  datftimine  how  fast  a  job  executes: 

A  -BO  MlNtlTe$  BILLING  FACTOR 

B  -  2  HOURS  2X  BILLING  FACTOR 

C  -  5  HOURS  IX  BILLING  FACTOR 

JB  -  24  HOURS  .€X  BILLING  FACTOR 

O  -  HOURS  .  3X  BILLING  FACTOR 

What  FRIORITY  LEVBL  will  this  job  have"?  _ 


The  higher  the  priority  level,  the  more  expensive  the  job 
is  to  run. 


Do  you  want  an  ANNUAL  flood  frequency  analysis 
following  WRC  Guidelineft  Bulletin  17 ’B 
pet formed  on  thie  data?  lY/N) 

Enter  dates  of  interest  at  the  following  prompts. 

If  the  entire  record  is  of  interest »  leave  year  blank. 

Enter  FIRST  YEAR  »nd  iiONTH  iyyyymrol  ^ 

Enter  LAST  YEAR  and  MONTH  tyyyymm)  _ 


Years  are  in  water  years;  that  is,  October  is  month  1  and 
September  is  month  12. 


Enter  an  8 -digit  STATION  NUMBER 

Enter  additional  STATION  NUMBERS  {Maximum  of  ifl) 

Terminate  by  entering  ft  0  (rero) 

The  request  file  you  have  created  is  [the  name  specified  when 
the  program  waa  invoked  will  be  displayed  here) ,  Transfer 
thift  filft  to  the  AMDAHL  Computer  in  Reston,  VA  using  a  micro¬ 
computer  comwftinications  software  package. 


If  you  receive  this  message,  you  have  probably  success¬ 
fully  created  the  PEAK  request  job.  Figure  2. 13  is  a  sample 
PEAK  request  job. 

Things  to  check: 

•  Are  all  characters  in  UPPER  CASE? 

•  Are  the  correct  user  ID  and  account  number  entered 
online  1? 

•  Are  there  quotes  around  your  agency  and  initials  and 
are  they  separated  with  a  comma  (line  1)7 

•  Did  you  specify  the  job  priority  level  (CLASS=)  that 
you  desire  on  line  2? 

•  Is  there  an  8-digit  station  number  on  the  I  line(s). 

•  Does  the  second  to  the  last  line  contain  the  characters 
/*? 

•  Does  the  last  line  contain  the  characters  //? 

If  any  of  the  above  items  are  missing  or  incorrect,  the 
job  will  not  run.  You  may  correct  simple  errors  such  as  user 
ID  and  account  number  with  an  editor.  If  other  errors  are 
identified,  it  is  recommended  that  PEAK  be  run  again  and 
the  file  recreated. 

The  Peak  streamflow  values  request  file  is  now  ready  to 
be  uploaded  to  the  Amdahl  mainframe  computer  in  Re- 
ston,  Virginia,  using  a  microcomputer  communications 
package.  Refer  to  Appendix  G  for  instructions  for  logging 
on  to  the  Amdahl  computer,  submitting  jobs  for  process¬ 
ing,  and  recovering  output  from  the  WYLBUR  Fetch 
Queue. 

Before  printing  information  obtained  from  WATSTORE 
using  a  request  file  created  by  PEAK,  the  PAGEBR  pro¬ 
gram  could  be  run  on  the  WATSTORE  output  file  to  insert 
a  printer  control  character  at  points  where  printing  should 
begin  on  a  new  page. 


//ABCD123  JOB  (1234567 89 , H475 , 10 , 20 , 3000) USFWS , CLL* , 
//  CLASS=C,MSGLEVEL-2, 0) 

/♦ROUTE  PRINT  RMT240 
/★route  punch  RMT240 

//PROCLIB  DD  DSN-WRD.PROCLIB,DISP=SHR 

//SI  EXEC  PGM=IEBGENER 

//SYS PRINT  DD  SYOUT=A 

//SYSUT2  DD  SYSOUT=A,DCB=BLKSIZE=80 

//SYS IN  DD  DUMMY 

//SYSUTl  DD  * 

/* 

//S2  EXEC  PEAKRET, AGENCY =USGS 
//HDR.SYSIN  DD  * 

M  197010  198009 
XJ407  $JOB 
I  06710000K 

//  EXEC  PKWRCA 
/* 

// 


Fig.  2.13.  Sample  PEAK  request  job. 
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QIN  Program 


Introduction 

The  QIN  program  creates  a  daily  streamflow  file  in 
WATSTORE  format  or  a  monthly  streamflow  file  in  USGS 
format.  Information  can  be  entered  interactively  from  the 
keyboard  or  be  read  from  a  free-formatted  ASCII  file 
created  with  an  editor.  It  is  recommended  that  the  data  be 
entered  into  a  free-formatted  ASCII  file  instead  of  entering 
it  interactively  from  the  keyboard,  as  the  entiy  of  a  year  of 
daily  flow  values  is  tedious  and  error  prone  and  no  editing 
is  allowed  during  data  entry. 

If  the  data  is  entered  into  a  free-formatted  ASCII  file,  it 
must  contain  the  responses  to  each  of  the  prompts  when 
the  data  is  entered  interactively  from  the  keyboard.  Each 
response  should  be  separated  by  a  space  or  a  carriage 
return.  Type  INFODQ  or  INFOMQ  for  information  on  the 
format  of  the  free-formatted  input  file  for  daily  or  monthly 
streamfiows.  Figure  2.14  contains  a  sample  daily  flow 
free-formatted  ASCII  text  file  used  as  input  to  QIN. 

Running  QIN 

RQIN,ZQFIL,ZQIN 

ZQFIL  =  Daily  streamflow  file  in  WATSTORE 
format  or  monthly  streamflow  data  in 
USGS  format  (output). 

ZQIN  “  Free-formatted  ASCII  text  file  contain¬ 
ing  responses  to  program  prompts.  If  no 
filename  is  entered,  keyboard  input  is 
assumed  (input). 


If  data  is  being  read  from  a  free-formatted  file,  the 
filename  must  have  been  entered  when  RQIN  was  run,  and 
the  file  must  contain  responses  for  each  of  the  following 
prompts.  Type  INFODQ  or  INFOMQ  for  information  on 
the  format  of  the  free-formatted  daily  or  monthly  input 
streamflow  files.  Years  of  data  may  be  separated  by  a 
carriage  return,  if  desired,  for  easier  file  readability. 


012142000 

47 

36 
54 
121 
42 

44 
53 
33 
SW 

17110010 

64 

100 

1130 

N.F.  SNOgUALMIE  RIVER  NR  SNOQUALMIE  PALLS,  WA. 

1 

1929 

10 

40  39  39  115  260  136  105  86 
124  120  94  84  79  73  68  67 
236  177  253  198  150  121  104  91 

82  83  164  158  124  110  99 

91  106  92  84  87  138  111  100 

116  149  131  117  109  101  98  130 

389  223  155  130  115  105  97  91 

144  162  148  134  121  115 

108  98  91  85  104  161  144  163 

285  469  380  248  415  2490  1080  820 

571  410  395  371  321  555  1170  680 

885  627  634  457  380  677  576 

1120  740  654  571  473  365  288  250 

213  196  130  130  130  130  130  130 

130  130  130  110  110  110  110  110 

110  110  110  110  119  117  259 

2640  1200  700  1720  2290  940  1360  1170 

660  897  885  571  457  555  1100  1400 

1200  1330  1730  1260  802  605  489  395 

333  285  250  225 

217  206  194  185  187  178  178  189 

194  185  202  253  208  185  169  158 

156  156  176  187  862  845  457  1520 

1590  1030  820  930  908  640  554 
505  457  426  457  505  505  1110  1120 
622  457  410  457  505  571  660  473 

395  380  410  505  700  720  554  522 

473  489  554  522  395  318 

327  505  489  359  296  336  296  255 

236  234  272  315  441  489  426  489 

380  327  386  1030  980  1030  740  660 
554  441  441  489  457  457  538 

660  840  605  489  473  565  588  489 

457  457  457  473  426  327  362  362 

257  234  267  288  296  250  223  213 

204  223  377  489  327  267 

248  221  187  171  172  166  150  143 

137  136  126  121  117  113  106  100 

98  93  90  87  86  83  80  77 

74  70  66  64  62  61  59 

58  56  55  54  53  53  52  51 

49  49  47  47  45  44  44  44 

45  44  43  41  41  41  40  39 

39  38  37  37  36  36  37 

37  36  35  34  34  40  41  42 

56  51  48  51  76  276  142  96 

83  74  68  64  60  57  55  52 

Fig.  2.14.  Sample  free-formatted  ASCII  file  used  as  input  to 
QIN. 


ENTER  FORMAT  OP  FILE  BEING  CREATED: 

X  FOR  WATSTORE  FORMAT  (DAILY  STREAMFLOW  FILE) , 
2  FOR  USGS  FORMAT  (MONTHLY  STREAMFLOW  FILE) . 

ENTER;  0  TO  ENTER  DATA  BY  KEYBOARD, 

1  TO  USE  DATA  FROM  FREE - FORMATTED  FILE. 
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If  “1”  is  entered  to  create  daily  streamflow  data  in 
WATSTORE  format: 


Note;  The  prompts  Biter  gaging  station  ID  through 
Datum  contain  data  used  in  the  WATSTORE 
system  data  files.  The  TSLIB  programs  do  not 
use  these  data,  except  for  LSTDQ,  which 
merely  displays  the  values.  If  you  do  not  care  to 
use  the  values  in  the  first  line  of  the  data  set,  or 
do  not  know  the  proper  values,  you  may  substi¬ 
tute  dummy  values.  After  the  output  file  has 
been  created,  you  may  edit  the  first  line  of  the 
data  set  to  be  another  title  line,  with  the  title 
information  starting  in  column  17.  The  daily 
streamflow  file  would  then  have  two  title  lines. 


:■ ;  ENTER  caging  :  STATION T5  MAX  iiCHARS ■ :  •  ■ : .  ’ xx:.  .  ■  : .  J- 

Enter  the  gaging  station  ID  where  the  observations  for 
the  data  set  were  made.  Each  line  of  the  daily  streamflow 
file  will  have  the  identifier  entered  on  it.  The  program 
prints  out  15  dashes  so  you  will  not  exceed  the  15-charac- 
ter  limit.  You  may  include  leading  blanks,  if  you  wish. 


LOCATION 

DEGREES  LATITUDE: 

WINOTES  LATITUDE: 

SECONDS  LATITUDE f 

DEGREES  LONGITUDE? 

MINUTES  LONGITUDE : 

SECONDS  LONGITUDE?  _ _ _ 

There  is  a  certain  amount  of  range  checking  here  so  that 
most  absurd  numbers  cannot  be  entered  by  mistake. 

jSTATE  CODE:  (NUMBER  BETWEEN  00  AND  99)  x; :  ■■ 

Enter  the  State  code  for  the  State  in  which  the  data  was 
measured.  State  (and  county)  codes  are  found  in  Federal 
Information  Processing  Standards  Publication  (FIPS 
PUB)  6-3,  1979.  FIPS  PUB  6-3  is  entitled  Counties  and 
County  Equivalents  of  the  States  of  the  United  States  and 
the  District  of  Columbia.  This  publieation  implements 
American  National  Standard  X3.31-1973  (ANSI  X3.31- 
1973).  Copies  of  this  publication  are  for  sale  by  the  Na¬ 
tional  Technical  Infoimation  Service,  U.S.  Department  of 
Commerce,  Springfield,  Virginia  22161.  When  ordering, 
refer  to  Federal  Information  Processing  Standards  Publi¬ 
cation  6-3  (NBS-FIPS-PUB-6-3).  If  you  want  to  enter  a 
dummy  value,  enter  00. 

:  ■  COUNTY  .:.CODE;  i:;::(NUMBER  BETWEEN  0  AND  999). ..  .  .  ;  - 

Enter  the  county  code,  as  listed  in  NBS-FIPS-PUB-6-3. 
For  example,  King  County,  Washington,  has  the  code  033. 
You  may  enter  just  the  33,  the  program  will  fill  in  the 
leading  zero.  If  you  want  to  enter  a  dummy  value,  enter 
000.  The  county  code  will  appear  on  the  first  line  of  the 
data  set. 


-CHARS 

Enter  the  site  code.  If  you  have  no  site  code,  enter  a 
dummy  value  of  2  alphanumeric  characters. 

ia  HYDROLOGIC  UNIT  NUMBERlBETWBEN  0  AND  9  9999999 ) 


Enter  the  hydrologic  unit  identifier.  This  must  be  an 
integer  number  from  0  to  99999999.  Any  integer  in  this 
range  will  suffice  for  a  dummy  value. 

drainage;  AREA s. : . (NUMBER ::!:)aETWEEN  X  AND  9999?9?M:55£-.v^ 


Enter  the  drainage  area  of  this  hydrologic  unit.  The  value 
should  be  from  1  to  9999999.  It  may  contain  decimal 
values,  if  the  area  is  <  9999.99. 

::;:;:CObrrRIBUTING:PR^NAGE;;;AREAi^^  AND  999999 9 


Enter  the  area  of  the  hydrologic  unit  above  the  gaging 
station  (that  area  directly  contributing  to  the  discharge  at 
this  site).  The  value  may  be  from  0  to  9999999. 

:PATUM ; {NUMBER ;  BETWEEN  O  vAND.:  9 $ 9.9 & 99 9 >  ■, 

Enter  the  datum  value  as  specified  by  the  WATSTORE 
documentation.  The  data  we  will  be  entering  are  discharge 
(cfs),  daily  mean.  The  DATUM  value  can  be  0  to 
99999999.  A  good  dummy  value  is  0. 

C  enter  A  title  name  for  this  pATA  ;  SETi::!!<MAx 


Enter  a  descriptive  name  for  the  data  or  the  site  from 
which  the  data  were  taken. 


Note:  From  this  point  on,  no  dummy  values  should  be 
entered. 


ENTER  0  FOR  BREAKS  -IN:  YEARS,  :  1  FOR:  NO;  BREAKS : 


If  the  years  of  data  are  all  sequential,  enter  1.  If  there  is 
1  year  (or  more)  of  data  missing  from  the  data  to  be 
entered,  enter  0.  For  example,  if  the  data  are  for  1983, 
1984, 1985, 1986, 1987,  and  1988  you  would  enter  1.  If  at 
least  1985*s  data  were  missing,  you  would  enter  0. 


>:v ENTER  YEAR; 


If  you  entered  “1  ”  above,  this  prompt  appears  for  the  first 
year.  Enter  the  first  year  for  which  you  will  enter  data.  If 
there  are  breaks  in  years,  you  will  see  this  prompt  for  each 
year  of  data  you  enter. 

ENTER  STARTING  M(»rrH  >  ( X  2 )  t  ~ 


You  do  not  have  to  enter  data  beginning  with  January. 
You  may  wish  to  enter  the  data  for  a  water  year  (beginning 
in  October).  The  program  will  change  years  when  the  data 
for  the  next  January  is  encountered  in  the  input  data. 


QIN  Program 
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SNTBR  t>AlLY  DKTh  h  YEAR 

{365  PAYS) ; _ 

Enter  the  daily  mean  discharge  in  cubic  feet  per  second 
for  the  number  of  values  prompted  for,  separated  by  one 
or  more  spaces,  a  carriage  return,  or  a  comma.  To  repeat  a 
value,  enter  repeat  factor*value.  For  example,  3*55  = 
entering  55  three  times. 

The  program  expects  365  values,  except  for  leap  years 
when  366  values  are  to  be  entered.  (In  the  year  2000, 367 
values  will  need  to  be  entered,  as  this  is  a  double  leap  year, 
with  30  days  in  February.) 

:  ENTER  Q  TO  STOP  OR  1  TO  ADD  DATA  FOR -MORE  YEARS. 


Enter  a  gaging  station  ID  to  be  written  to  the  output  file, 
8  characters  or  less. 


:::y.ENTER  0  FOR  BREAKSjilN  ::YEARS ,  1  RQR  NQ  BREAKS. _ 

If  the  years  of  data  are  all  sequential,  enter  1.  If  there  is 
1  year  (or  more)  of  data  missing  from  the  data  to  be 
entered,  enter  0. 

If  “0”  is  entered  for  “break  in  years”: 

ifeE^TER  YEAR,  y.  V 

Enter  year  for  data  being  entered. 

If  “1”  is  entered  for  “tio  breaks”: 


Note:  If  you  are  entering  the  data  into  a  free-formatted 
file,  do  not  enter  a  value  for  this  prompt. 


If  you  choose  to  enter  more  data  you  will  be  prompted 
as  follows,  depending  on  whether  there  are  breaks  in  years 
of  data  or  if  the  data  is  in  sequential  years. 

If  “0”  was  entered  to  indicate  that  there  were  breaks  in 
years,  the  program  will  return  to  the  prompt  Enter  year  and 
continue  from  there. 

If  “1”  was  entered  to  indicate  that  there  were  no  breaks 
in  years,  then  you  will  be  prompted  to  enter  the  data  for 
the  next  year. 

If  “2”  was  entered  to  create  monthly  streamflow  data 
in  uses  format: 


jENTER  TITLE  OF  DATA  (2  LINES)  - _ ^ _ 

The  first  two  lines  in  the  monthly  streamflow  data  file 
may  contain  up  to  80  characters  per  line  to  record  infor¬ 
mation  such  as  the  name  of  the  river,  section  of  the  river 
involved,  and  any  other  information  describing  the  data. 

ENTER  STATICS  TDEOTIFICATION  v:(8  CHARE  MAX)  ? 


ENTER  FIRST  YEAR _ 

Enter  the  first  year  for  which  you  have  data .  The  program 
will  continue  the  sequence  of  years. 


ENTER  MONTHLY  DATA _ 

Enter  the  12  data  values  for  the  year.  These  values  may 
be  entered  one  per  line  (a  number  followed  by  pressing 
either  the  return  or  enter  key)  or  may  be  entered  several 
per  line,  separated  by  a  comma  and  (or)  one  or  more 
spaces. 


RENTER  0  to: STQR  OR  1  TQ  ADO  DATA  FOR  MORE  YEARS . 


Note:  If  you  are  entering  data  into  a  free-formatted 
file,  do  not  enter  a  value  for  this  prompt. 


If  you  choose  to  enter  more  data,  you  will  be  prompted 
as  follows  depending  on  whether  there  are  breal^  in  years 
of  data  or  if  the  data  is  in  sequential  years. 

If  “0”  was  entered  to  indicate  that  there  were  breaks  in 
years,  the  program  will  return  to  the  prompt  enter  year  and 
continue  from  there. 

If  “1  ”  was  entered  to  indicate  that  there  were  no  breaks 
in  years,  then  you  will  be  prompted  to  enter  the  data  for 
the  next  year. 
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SELDUR  Program 


Introduction 

The  SELDUR  program  takes  a  WATSTORE  duration 
analysis  file  (created  by  submitting  the  request  file  created 
by  DURTBL  to  WATSTORE)  and  creates  a  smaller  file 
with  the  same  informatiim  that  can  be  used  as  input  to  the 
DQDUR  program. 

The  DQDUR  program  will  accept  the  large  WAT- 
STORE  duration  analysis  file  as  input  or  the  reduced  file 
created  by  SELDUR.  If  the  large  WATSTORE  file  is  used 
as  input,  DQDUR  will  automatically  run  SELDUR  and 
create  the  reduced  file  as  output. 


Running  SELDUR 

RSELDUR,  WATDUR.  ZREDUR 

WATDUR  “  WATSTORE  duration  analysis  file  (in¬ 
put). 

ZREDUR  *  Reduced  WATSTORE  duration  analysis 
file  (output). 

The  reduction  process  takes  a  while  to  complete.  A  mes¬ 
sage  will  appear  when  the  reduction  is  completed. 


Habitat  Area-Versus-Streamflow  Function 
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Chapter  3. 

Entry,  Manipulation,  Listing,  and  Display  of  the  Habitat 
Area-versus-Streamflow  Function 


Introduction 

Users  of  TSLIB  are  responsible  for  obtaining  a  credible 
physical  habitat  area-versus-streamflow  function  for  each 
life  stage  and  species  to  be  analyzed.  This  function  may  be 
output  from  the  habitat  simulation  programs  contained  in 
the  Physical  Habitat  Simulation  System  (PHABSIM)  or 
can  be  entered  directly  by  the  user  using  the  CRHAQF 
program. 

The  end  result  of  PHABSIM  is  a  habitat  area-versus- 
streamflow  function  (ZHAQF  file)  for  any  number  of 
species  and  life  stages.  Programs  in  PHABSIM  can  be  used 
to  merge  various  ZHAQF  files  with  the  goal  of  developing 
a  habitat  area-versus-streamflow  function  applicable  to  a 
reach  of  river. 

Please  note  that  the  use  of  PHABSIM  is  not  the  only  way 
of  developing  a  credible  habitat  area-versus-streamflow 
function;  any  other  system  or  logic  may  be  used.  In  all 
cases,  a  credible  habitat  area-versus-streamflow  function 
is  required. 

The  programs  presented  in  Chapter  3  are  intended  to 
help  the  user  display  the  habitat  area-versus-streamflow 
function  in  various  ways  and  to  manipulate  the  function 
with  a  goal  of  better  understanding  the  nature  of  the  system 
being  analyzed.  (Note:  The  SUMHQF,  HBOUTA,  and 
LPTHQF  programs  included  in  Chapter  3  are  also  in 
PHABSIM.) 

After  the  desired  habitat  area-versus-streamflow  func¬ 
tion  is  obtained,  analysts  often  need  to  look  at  the  data  or 
present  the  data  in  a  form  that  can  be  useful  for  report 
writing.  The  HABOUT  and  HBOUTA  programs  are  avail¬ 
able  to  write  data  in  various  ways  without  doing  much 


analysis  in  the  process.  The  LPTHQF  program  can  be  used 
to  plot  the  habitat  area-versus-streamflow  function  using 
character  or  screen  graphics. 

The  habitat  area-versus-streamflow  function  may  be  for 
individual  cross  sections  or  other  subsets  of  the  segment 
for  which  a  single  function  for  each  life  stage  is  desired. 
The  COMHQF  program  is  available  to  combine  ZHAQF 
files  from  more  than  one  site  to  better  represent  a  stream 
segment. 

Sometimes  it  is  desirable  to  change  the  way  the  various 
life  stages  and  species  are  organized  in  a  file  (or  files).  For 
example,  if  the  analyst  is  just  interested  in  reviewing  data 
for  one  life  stage  of  one  or  more  species,  the  MRGHQF 
program  could  be  used  to  merge  several  files  to  create  a 
single  file  containing  the  desired  information. 

In  reviewing  the  habitat  area-versus-streamflow  func¬ 
tion,  the  relative  value  of  the  habitat  for  different  life  stages 
or  species  can  sometimes  cause  confusion.  In  this  instance, 
the  NRMHQF  program  can  be  used  to  express  the  habitat 
as  percent  of  the  peak  habitat  for  the  life  stage. 

For  many  studies  it  is  useful  to  transfer  a  known  habitat 
area-versus-streamflow  function  within  a  watershed.  The 
NRMHQF  program  can  be  used  to  normalize  the  function 
to  facilitate  the  transfer. 

In  those  situations  where  the  mean  monthly  flow  or  some 
other  monthly  statistic  is  known,  it  is  desirable  to  work 
with  this  data  without  all  the  other  programs  in  TSLIB.  The 
HAQINT  and  HABOUT  programs  allow  the  user  to  select 
this  option.  For  example,  if  the  mean  monthly  flow  is 
known,  it  may  be  useful  to  determine  and  display  the 
habitat  associated  with  this  mean  monthly  flow. 
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Direct  Entry  of  the  Habitat  Area-versus-Streamflow  Data 

Program  BatdVRxx^edure 

Name  Fileaiamc  _ Program  Description _ 

CRHAQF  RCRHAQF  ZHAQF  Creates  a  habitat  area-versus-streamflow  file  in  the  same  format  as  ere- 

file  entry  ated  by  the  habitat  simulation  programs  in  PHABSIM.  The  program 

prompts  for  flows  and  weighted  usable  areas  (WUA).  An  unlimited 
number  of  species,  each  with  1-5  life  stages,  can  be  included. 

RCRHAQF,  ZHAQF 

ZHAQF  =  Habitat-versus-flow  file  (output). 


Manipulation  of  the  Habitat  Area-versus-Streamflow  Data 


Program  BatclVProceckiie 
NaiTK  Filename  Function 

COMHQF  RCOMHQF  ZHAQF 

file 

manipulation 


_ Program  Description _ 

Sums  or  combines  habitat  area  data  from  two  habitat  area-versus- 
streamflow  files.  Weighting  factors  are  supplied  by  the  user  when  files 
are  combined.  The  weight  for  the  first  file  must  be  less  than  or  equal  to 
“l.”The  weight  for  the  second  file  is  assumed  to  be  “P  minus  the  first 
file  weight.  Any  number  of  ZHAQF  files  may  be  combined  by  adjust¬ 
ing  the  weight  factors  and  running  COMHQF  on  two  ZHAQF  files  at 
a  time. 


RCOMHQF,  ZHAQFN,  ZHAQF,  ZHAQF2,  ZOUT 
ZHAQFN  =  Summed  or  combined  habitat-versus-flow  file  (output), 
ZHAQF  =  Habitat-versus-flow  file  (input). 

ZHAQF2  =  Habitat-versus-flow  file  (input). 


ZOUT  ~  Summed  or  combined  habitat  area  in  tables  for  each  life 
stage  (output). 

HAQINT  RHAQINT  ZHAQF  Uses  a  given  habitat  area-versus-streamflow  file  to  estimate  habitat  for 

file  different  flows  by  interpolation, 

manipulation 


RHAQINT,  ZHAQFN,  ZHAQF 

ZHAQFN  =  Habitat-versus-flow  file  for  requested  flows  (output). 


ZHAQF  =  Habitat-versus-flow  file  (input). 


HABnAT  Area-Versus-Streamflow  Data 
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Program  BatclVProceduie 
Name  Filename 


MRGHQF  RMRGHQF 


MULHQF  RMULHQF 


NRMHQF  RNRMHQF 


SUMHQF  RSUMHQF 


Rmcticm 


ZHAQF 

file 

manipulation 


ZHAQF 

file 

manipulation 


ZHAQF 

file 

manipulation 


ZHAQF 

file 

manipulaticn 


Program  Description 


Extracts  up  to  five  life  stages  from  one  or  two  habitat  area-veisus- 
streamflow  files  and  creates  a  new  habitat  aiea-versus-streamflow  file. 

RMRGHQF,  ZHAQFN,  ZHAQF,  ZHAQF2 

ZHAQFN  =  Habitat-versus-flow  file  with  selected  life  stages  (output). 

ZHAQF  ^  Habitat-versus-flow  file  (input). 

ZHAQF2  Habitat-versus-flow  file  (input). 

Weights  individual  life  stages,  or  multiplies  or  divides  habitat  values  in 
a  habitat  area-versus-streamflow  file  by  a  constant. 

RMULHQF,  ZHAQFN,  ZHAQF 


ZHAQFN  =  Habitat-versus-flow  file  with  adjusted  habitat  values 
(output). 

ZHAQF  =  Habitat-versus-flow  file  (it^)ut). 

Normalizes  habitat  values  in  a  habitat  area-versus-streamflow  file  with 
respect  to  a  given  discharge  and  the  corresponding  area.  If  the  given 
discharge  is  not  on  the  file,  it  will  be  added  and  the  habitat  values  will 
be  calculated  by  interpolation  for  the  discharge.  If  the  first  record  in 
the  input  file  is  not  area,  the  user  will  be  prompted  to  enter  the  area. 

RNRMHQF,  ZHAQFN,  ZHAQF 

ZHAQFN  =  Normalized  habitat-versus-flow  file  (output). 

ZHAQF  =  Habitat-versus-flow  file  (input). 

Sums  conditional  cover  columns  in  a  ZHAQF  file  into  one  habitat- 
versus-flow  figure  for  each  life  stage.  Run  when  conditional  cover 
curves  were  used  as  input  to  the  habitat  simulation  programs.  Allows 
up  to  five  life  stages  to  be  grouped  in  each  record. 

RSUMHQF,  ZHAQF,  ZHAQFN 

ZHAQF  Habitat-versus-flow  file  (input). 


ZHAQFN  =  Modified  ZHAQF  file  with  columns  summed  (output). 
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Listing  of  the  Habitat  Area-versus-Streamflow  Data 

Program  BatdVPtoceduie 

Name  Filename  Rmetion  _ Program  Descriptitm _ 

Arranges  a  habitat  area-versus-streamflow  file  by  month  and  deter¬ 
mines  the  total  area  per  1,000  feet  of  stream  water  for  each  flow,  with 
an  option  to  compute  a  yearly  average  for  each  flow.  HABOUT  also 
computes  the  adult  equivalent  habitat  for  each  species. 

RHABOUT,  ZHAQFM,  ZOUT,  ZHAQFN 

ZHAQFM  *  Habitat-versus-flow  file  for  12  months  (input).  Same 
format  as  ZHAQF  file  except  only  12  values  are  en¬ 
tered,  1  per  month.  If  more  than  12  values  are  in  the 
input  file,  only  the  first  12  are  read. 

ZOUT  HABOUT  results  (output). 

ZHAQFN  “  Habitat-versus-flow  file  with  adult  equivalent  habitat 
values  (output). 

Writes  the  data  fiom  a  habitat  area-versus-streamflow  file  into  a  for¬ 
mat  that  may  be  useful  for  report  purposes. 

RHBOUTA,  ZHAQF,  ZOUT 

ZHAQF  =  Habitat-versus-flow  file  (input). 

ZOUT  =  HBOUTA  results  (output). 

Display  of  the  Habitat  Area-versus-Streamflow  Data 

Program  BatclVHxxjedure 

Name  Filenarr^  Function  _ Program  Descriptim _ 

LPTHQF  RLPTHQF  ZHAQF  Plots  the  habitat-versus-flow  functirxis:  one  species  per  page;  1-5  life 

file  stages, 

display 

RLPTHQF,  ZHAQF,  ZOUT 
ZHAQF  =  Habitat-versus-flow  file  (input). 

ZOUT  =  LPTHQF  results  (output). 


HBOUTA  RHBOUTA  ZHAQF 

file 

listing 


HABOUT  RHABOUT  ZHAQF 

file 

listing 
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COMHQF  Program 


Introduction 

The  COMHQF  program  sums  or  combines  habitat  area 
data  from  two  habitat-versus-streamflow  files.  Figure  3.1 
is  an  example  of  how  the  COMHQF  program  is  used. 

The  sum  option  in  COMHQF  could  be  used  when  a 
cross  section  has  an  island  in  it.  In  this  case,  both  sides 
of  the  island  would  be  simulated  separately,  which  would 
result  in  two  ZHAQF  files  for  the  cross  section.  These 
two  ZHAQF  files  could  be  combined,  which  would  result 
in  one  habitat  area-versus-streamflow  file  for  the  cross 
section. 

The  combine  option  in  COMHQF  could  also  be  used 
when  the  analyst  developed  a  habitat  area-versus- 
streamflow  function  for  each  individual  cross  section  (or 
a  subset  of  the  total).  In  most  situations  it  is  better  to  create 
a  single  habitat  area-versus-streamflow  function  for  a  seg¬ 
ment.  The  COMHQF  program  could  be  used  to  combine 
the  individual  cross-sectional  (or  reach)  data  based  on 
weighting  factors  supplied  by  the  user.  The  weight  for  the 
first  file  must  be  less  than  or  equal  to  “1.”  The  weight  for 
the  second  file  is  assumed  to  be  “1”  minus  the  first  file 
weight.  Any  number  of  ZHAQF  files  may  be  combined  by 
adjusting  the  weight  factors  and  running  COMHQF  with 
each  set  of  two  files. 


Running  COMHQF 

RCOMHQF,  ZHAQFN,  ZHAQF,  ZHAQF2,  ZOUT 

ZHAQFN  =  Summed  or  combined  habitat-versus- 
flow  file  (output). 

ZHAQF  =  Habitat-versus-flow  file  (input). 

ZHAQF2  =  Habitat-versus-flow  file  (input). 

ZOUT  *  Summed  or  combined  habitat  area  in 
tables  for  each  individual  life  stage  (out¬ 
put). 

The  two  title  lines  from  the  two  input  files  are  displayed. 

ENTER  TWO  LINE  TITLE 


These  two  title  lines  will  be  in  the  summed  or  combined 
output  file. 


If  the  life  stage  lines  are  not  the  same  on  both  ZHAQF 
files  specified  as  input,  the  following  message  will 
appear  (but  the  program  will  not  terminate): 

“Warning — ^Life  stage  titles  do  not  match.  Will  use 
life  stage  title  from  first  HAQF  file” 


Cross 
Section  5 

Cross 
Section  4 


Cross 
Section  3 

Cross 
Section  2 


ZHAQF3 


2HAQF2 


Fig.  3.1.  Using  COMHQF  first  to  combine 
habitat  area-versus-streamflow  functions 
for  reach  2,  then  for  the  segment  as  a 
whole. 


Cross 

Section  1  J 
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Input  files  need  to  be  in  the  same  fomat  and  contain  the 
same  type  of  infonnation  to  be  logically  combined — that 
is,  combining  different  habitat  simulation  figures  for  dif¬ 
ferent  discharges,  species,  and  life  stages  of  fish  would  be 
illogical. 


Rm*  exan^le,  suppose  there  are  three  ooss  sections  with 
individual  cross-sectional  weights  of  Wi,  W2,  and  W3  that  sum 
to  1.0.Iheequatic«ifcM*thesegiiieiitasawhole(HAS)is 

HAS  -  WiHAi  +  W2HA2  -  W3HA3, 
which  can  be  arranged  to 


PNTEK  Q  to  tWQP  PILES. 

X  TO  OOMBIKB  WEtOHTS ; _ _ 

If  ‘HI”  is  entered  to  sum  HAQF  files,  the  following 
logic  is  used: 

Q2  =  Q2L  +  Q2R 

HA2  *  HA2L  +  HA2R 

For  example,  the  first  step  in  the  process  of  combining 
the  ZHAQF  files  in  Fig.  3 . 1  would  be  to  sum  the  two  parts 
for  reach  2  (ZHAQF2) — ^in  this  example,  the  habitat  areas 
and  streamfiow  sum. 

If  ‘‘1”  is  entered  to  combine  with  weights: 


Therefore,  for  the  first  time  through  COMHQF,  use 
weights  HAl  and  HA2  where 


HAl  =HAi 


Wl  = 


Wi 

W1  +  W2 


HA2  =  HA2  W2  = 


W2 

W1  +  W2 


and  the  end  product  is  HA12. 


for  wpa  set  X  - 

The  weight  for  the  first  file  must  be  <1.  The  weight  for 
the  second  file  is  assumed  to  be  1  minus  the  first  file 
weight. 

The  next  step  in  the  process  of  combining  ZHAQF  files 
in  Fig.  3.1  would  be  to  combine  the  three  individual 
ZHAQF  files  with  weights  to  result  in  a  habitat-versus- 
flow  functicm  for  the  segment: 

Q  =  Qi  =  02  Q3 

HAS  =  WiHAi  +  W2HA2  =  W3HA3 

The  equation  used  when  combining  two  files  with 
weights  is 

HAS  -  (HAl  X  WI)  +  (HA2  x  W2) 

W2=  1.0 -WI 
Wl<  1.0 
Ql=  Q2 

where 

HAl  =  habitat  area  from  the  first  HAQF  file, 

HA2  =  habitat  area  from  the  second  HAQF  file, 
(this  file  could  be  the  result  of  combining 
two  previous  files), 

HAS  *  combined  habitat  area, 

WI  =  weight  on  first  HAQF  file, 

W2  =  weight  on  second  HAQF  file, 

Q1  =  streamfiow  from  first  HAQF  file,  and 

Q2  “  streamfiow  from  second  HAQF  file. 


First  ZHAQF  file  used  as  input  to  COMHQF: 

SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS.  WA 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220,00 

5780.00 

100.00 

15400.00 

4770,00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

9410.00 

350.00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500 . 00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9  27  0 . 0  0 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000.00 

7210.00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

*************** 

Second  ZHAQF  file 

used  as  input  to  COMHQF: 

SNOQUALMIE  RIVER  ] 

NEAR  SNOQUALMIE  FALLS,  WA 

SAMPLE  ZHAQF  FILE 

TO  USE  WITH 

THE  COMHQF  PROGRAM. 

RAINBOW  TROUT 

DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

2050.00 

822.00 

578.00 

100.00 

1540.00 

477.00 

320.00 

150.00 

1888.00 

723.00 

489.00 

200 . 00 

1979.00 

936.00 

641.00 

250.00 

1978.00 

1147.00 

802.00 

300.00 

1911.00 

1314.00 

941.00 

350.00 

1805.00 

1411.00 

1040.00 

400.00 

1629.00 

1585.00 

1260.00 

500.00 

1447.00 

1636.00 

1366 .00 

600.00 

1103.00 

1461.00 

1338.00 

800.00 

909.00 

1231.00 

1174,00 

1000.00 

741.00 

927.00 

888 . 00 

1500.00 

694.00 

849.00 

762.00 

2000.00 

721.00 

863.00 

781.00 

4000.00 

666 .00 

948.00 

851.00 

6000.00 

574.00 

989.00 

967,00 

Fig.  3.2.  Sample  input  files  to  COMHQF. 
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For  the  second  and  last  times  through  COMHQF,  use 
weights  HAl  and  HA2,  now  defined  as 

HA1  =  HAi2  W1=Wi+W2 

HA2  =  HA3  W2  =  W3 


and  the  end  product  is  HAS. 

Figure  3.2  contains  two  sample  input  files  for  the 
COMHQF  program.  Figure  3.3  is  sample  output  using  the 
sum  option.  Figure  3.4  is  sample  output  using  the  combine 
option. 


NEW  ZHAQF  FILE  FOR  SNOQUALMIE  RIVER  WHICH  RESULTED  BY  SUMMING 
THE  TWO  ZHAQF  FILES  IN  FIGURE  3.2  USING  THE  SUM  OPTION  IN  COMHQF 
RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

*  1 

20.00 

22620.00 

9042.00 

6358.00 

*  2 

200.00 

16940 . 00 

5247 .00 

3520.00 

*  3 

300.00 

20768.00 

7953.00 

5379.00 

*  4 

400.00 

21769 .00 

10296 .00 

7051.00 

*  5 

500.00 

21758.00 

12617 .00 

8822.00 

*  6 

600.00 

21021.00 

14454.00 

10351.00 

*  7 

700.00 

19855 . 00 

15521.00 

11440.00 

*  8 

800 . 00 

17919 .00 

17435.00 

13860.00 

*  9 

1000.00 

15917 .00 

17996.00 

15026.00 

*10 

1200.00 

12133 .00 

16071.00 

14718.00 

*11 

1600.00 

9999 .00 

13541.00 

12914.00 

*12 

2000.00 

8151.00 

10197 .00 

9768.00 

*13 

3000.00 

7634.00 

9339.00 

8382.00 

*14 

4000.00 

7931.00 

9493.00 

8591.00 

*15 

8000.00 

7326.00 

10428.00 

9361.00 

*16 

12000.00 

6314.00 

10879 .00 

10637 .00 

Fig.  33.  Sample  output  using  the  sum  option  in  COMHQF. 


NEW  ZHAQF  FILE  FOR  SNOQUALMIE  RIVER  WHICH  RESULTED  BY  COMBINING 

THE  TWO  ZHAQF  FILES  IN  FIGURE  3.2  WITH  A  WEIGHT  OF  .40  FOR  THE  FIRST  FILE 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

*  1 

10 . 00 

9458.00 

3781.20 

2658.80 

*  2 

100.00 

7084.00 

2194.20 

1472.00 

*  3 

150.00 

8684.80 

3325.80 

2249.40 

*  4 

200.00 

9103,40 

4305.60 

2948.60 

*  5 

250.00 

9098.80 

5276.20 

3689.20 

*  6 

300.00 

8790.60 

6044.40 

4328.60 

*  7 

350.00 

8303.00 

6490.60 

4784.00 

*  8 

400.00 

7493.40 

7291.00 

5796.00 

*  9 

500.00 

6656 .20 

7525 .60 

6283.60 

*10 

600.00 

5073.80 

6720.60 

6154.80 

*11 

800.00 

4181.40 

5662.60 

5400.40 

*12 

1000.00 

3408.60 

4264.20 

4084.80 

*13 

1500.00 

3192.40 

3905.40 

3505.20 

*14 

2000.00 

3316 .60 

3969.80 

3592.60 

*15 

4000.00 

3063.60 

4360.80 

3914.60 

*16 

6000.00 

2640.40 

4549 .40 

4448.20 

*************** 


Fig.  3.4.  Sample  output  using  the  combine  option  in  COMHQF.  A  weight  of  0.40  was 
used  for  the  first  file. 
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CRHAQF  Program 


Introduction 

The  CRHAQF  program  creates  a  habitat  area-versus- 
streamflow  (ZHAQF)  file  in  the  same  format  as  created 
by  the  habitat  simulation  programs  in  PHABSIM.  An 
unlimited  number  of  species,  each  with  1-5  life  stages, 
can  be  entered. 

The  CRHAQF  program  is  useful  when  the  habitat 
area^versus-streamflow  function  was  developed  using 
techniques  or  programs  not  in  PHABSIM. 

Running  CRHAQF 

RCRHAQF,  ZHAQF 

ZHAQF*  Habitat  area-versus-streamflow  file 
(output). 

ENTER  TITLE  ji  tTNISS) _ 


These  2  lines  may  contain  up  to  80  characters  per  line 
to  record  information  such  as  the  name  of  the  river, 
section  of  the  river  involved,  and  any  other  information 
describing  the  data. 


HOW  MANY  ■  FLOWS  (30  :  • . 

IenterSe  t-iiVixwst  ^ 

iiiiiiiiiiliii* 

Enter  each  flow  in  ascending  order,  followed  by  a 
space,  comma,  or  carriage  return. 

ENTER  SEECIES  IJAME  (40  CHAR  MAX)  ; _ ’ 


The  first  record  in  the  ZHAQF  files  created  by  the 
PHABSIM  programs  contains  total  area  information;  the 
TSLIB  programs  do  not  require  this  information.  If  it  is 
being  entered,  enter  ‘Total  area”  here  in  place  of  the 
species  name. 


HOW  MANY  LIFE  STAGES  {5  MAX)  i 


Enter  the  number  of  life  stages  for  this  species.  The 
weighted  usable  areas  (WUA)  will  be  entered  for  each  life 
stage  and  for  each  flow. 


If  Total  area  information  is  being  entered  as  the  first 
record,  enter  1  at  this  prompt  and  enter  “Area”  as  the 
life  stage  name  in  the  next  prompt. 


enter  life  stage  name  foe  set  (10  CHARS  MAX) 


This  prompt  appears  for  the  number  of  life  stages  speci¬ 
fied  for  the  species. 

ENTER  THE  [-^1  WUA*S  FOR  LtFE  STAGE?  [->^1 


Enter  a  weighted  usable  area  (WUA)  for  each  of  the 
flows  specified. 

ENTER  0  TQ  STOP.  OR  1  TO  ENTER  ANOTHER  SPECIES. 


Figure  3.5  is  a  sample  ZHAQF  file. 


SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200,00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

9410.00 

350.00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270.00 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000.00 

7210.00 

8630.00 

7810.00 

4000 . 00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

Fig.  3.5.  Sample  habitat  area-versus-streamflow  (2HAQF)  file. 
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Introduction 

The  HABOUT  program  arranges  a  habitat  area-versus- 
streamflow  file  by  month  and  determines  the  total  available 
area  per  1,000  feet  of  stream  water  for  each  flow,  with  an 
option  to  compute  a  yearly  average  for  each  flow.  HABOUT 
also  computes  the  adult  equivalent  habitat  for  each  species. 

The  HABOUT  program  is  a  carryover  from  the  early  days 
of  habitat  analysis  using  PHABSIM.  The  first  implementa¬ 
tion  of  a  time  series  analysis  was  to  develop  a  habitat 
area-versus-streamflow  function  with  12  values  of  dis¬ 
charge — 1  for  each  month.  A  common  case  was  when  the 
12  values  were  the  average  discharge  for  each  month.  The 
program  is  still  useful  when  the  median  discharge  is  an 
adequate  representation  for  time  series  analysis. 

Running  HABOUT 

RHABOUT,  ZHAQFM,  ZOUT,  ZHAQFN 

ZHAQFM*  Habitat-versus-flow  file  for  12  months 
(input).  Same  format  as  ZHAQF  file  ex¬ 
cept  only  12  values  are  entered,  1  per 
month.  If  more  than  12  values  are  in  the 
input  file,  only  the  first  12  are  read. 

ZOUT  =  HABOUT  results  (output). 

ZHAQFN  “  Habitat-versus-flow  file  with  adult 
equivalent  habitat  values  (output). 

ENTER:  0  TO  PRINT  OUT  EQUIVALENT  AREA  ONLY. 

1  To  PRINT  OUT  RABITAT  AREA  FOR  ALL  LIFE  STAGES 
FOR  REQUESTED  MONTHS.  OR 

2  TO  PRINT  OUT  HABITAT  AREA  FOR  REQUESTED  LIFE 

_ ■  STAGES  AND  MONTHS,  LEAVING  OTHERS  BLANK. _ 


If  ‘X)*’  is  entered,  only  the  table  of  month  versus  discharge 
and  the  equivalent  area  will  be  written  to  the  output  file. 

If  ”1”  is  entered,  the  user  specifies  the  months  to  be 
written  to  the  table  of  month  versus  discharge  and  the 
equivalent  area  that  is  written  to  the  output  file.  A  ‘Q 
versus  available  habitat  area  per  1,000  feet  of  stream  for 
(species  name)*"  is  also  written  for  the  months  specified. 

If  “2”  is  entered,  the  user  specifies  the  first  and  last  valid 
month  for  each  life  stage  and  a  weight  for  the  adult 
equivalent  area  for  each  life  stage. 

The  following  prompts  will  be  asked  if  options  1  or  2 
are  selected. 

The  months  on  the  data  set  are  displayed  along  with  their 
ID  number: 


ID  MONTH 

1  tIANOARY 

2  FEBRUARY 

3  MARCH 

12  DECEMBER 

■  ENTER  ID  FIRET  MONTH  OF  DATA  Stiti 


This  will  label  the  first  entiy  on  the  input  data  set  with 
the  corresponding  month  name.  For  example,  if  the  first 
entry  on  the  input  data  set  is  January,  enter  1.  If  the  fust 
entry  on  the  data  set  is  October,  enter  10. 


Enter  i  to  convert  from  English  to  metric,  z  for  no 

CONVERSIC^: 


Enter  1  if  you  want  the  output  printed  in  metric  units 
instead  of  English  (meters  instead  of  feet). 

ENTER  1  FOR  WUA  PRINTED  XY.RR.  2  FOR  WUA  PRINTED  XEs 


Weighted  usable  area  (WUA)  and  flow  (Q)  can  be 
printed  in  the  output  with  or  without  a  decimal  point. 

enter  1  FOR  Q  PRINTED  XX. XX,  2  FOR  Q  PRINTED  XX i 

ENTER  1  FOR  A  BINDING  EDGE,  2  FOR  NO  BINDING  EDGE.  ' _ 

The  binding  edge  is  on  the  top  of  the  paper. 

If  “1  ”  is  entered  for  a  binding  edge: 

ENTER  NUMBER  OF  LINES  FOR  BINDING  EDGE: 


If  option  2  was  selected,  the  following  prompts  will  also 
appear. 

Species  name  will  be  displayed  here. 

ENTER' FIRST  AND  LAST  VALID  MONTH  FOR  life  Stage: _ 

Enter  the  numbers  for  the  months  in  calendar  years  (i.e., 
June  through  October  would  be  6  through  10)  relevant  for 
the  life  stage  separated  by  a  space,  comma,  or  carriage 
return. 


ENTER  Weight  for  adult  equivalent  area  life  stage : 


Enter  the  weight  for  the  life  stage,  so  that  the  habitat  can 
be  adjusted  to  represent  the  adult  habitat  needed  if  all 
habitat  was  utilized. 


ENTER  1  FOR  ANNUAL  AVERAGE  WUA,  2  FOR  NO  AVERAGE  WUA: 

If  “1”  is  selected,  the  annual  average  will  be  calculated 
and  printed  in  the  output. 
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IJJTTER  1  TO  FRINT  UHITS  B£IX)W  TABI£,  2  FOR  NO  PRIHT  OF  UNITS ; 

If  “1”  is  entered,  the  following  will  be  printed  below 
each  table,  depending  on  whether  English  or  metric  units 
are  used: 

Q  IN  CUBIC  FEET  PER  SECOND,  WUA  IN  SQUARE 
FEET  PER  1,000  FEET 


Q  IN  CUBIC  METERS  PER  SECOND,  WUA  IN 

SQUARE  METERS  PER  1,000  METERS 

Figure  3.6  contains  a  sample  habitat  area^versus- 
streamflow  file  (in  months)  that  was  used  as  input  to  the 
HABOUT  program;  Fig.  3.7  is  sample  output  from  the 
HABOUT  program — option  2  was  selected  in  Fig.  3.7. 

The  adult  equivalent  would  be  written  to  the  ZH AQFN 
file. 


HABITAT  AREA  VS.  STREAMFLOW  FILE  USED  TO  CREATE 
SAMPLE  OUTPUT  FOR  HABOUT  PROGRAM 


RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

*  1 

396.00 

16414.64 

15723.83 

12439.00 

*  2 

612.00 

10689 .15 

14415.09 

13331.56 

*  3 

739.00 

9241.37 

12973.33 

12436.62 

*  4 

662.00 

9737 .56 

13750.97 

13064.51 

*  5 

480.00 

14874 .45 

16565.80 

13710.09 

*  6 

470.00 

15031.40 

16626.67 

13716.62 

*  7 

576.00 

11845.63 

15043.45 

13460.64 

*  8 

761.00 

9193.95 

12752.77 

12206.36 

*  9 

686.00 

9492.07 

13492.07 

12897 .74 

*10 

324.00 

18687  .79 

13577 .89 

9799 . 84 

*11 

145.00 

18617 .17 

6979  .73 

4715.70 

*12 

218.00 

19838.54 

10117  .76 

6973.32 

Fig.  3.6.  Sample  ZHAQFM  file  used  as  input  to  the  HABOUT  program. 


Q  VS.  AVAILABLE  HABITAT  AREA  PER  1000  FEET  OF  STREAM  FOR  RAINBOW  TROUT 


MONTH 

Q 

FRY 

JUVENILE  ADULT 

ADULT  EQUIVALENT 

JANUARY 

662 . 00 

13750.97 

13064.51 

13064 .51 

FEBRUARY 

480.00 

16565.80 

13710.09 

13710.09 

MARCH 

470.00 

16626.67 

13716 .62 

13716 .62 

APRIL 

576.00 

15043.45 

13460.64 

13460.64 

MAY 

761.00 

12752.77 

12206.36 

12206.36 

JUNE 

686 . 00 

9492 . 07 

13492.07 

12897  .74 

12897  .74 

JULY 

324.00 

18687 .79 

13577 .89 

9799 .84 

9799 .84 

AUGUST 

145.00 

18617 .17 

6979.73 

4715.70 

4715.70 

SEPTEMBER 

218.00 

19838 . 54 

10117.76 

6973,32 

6973.32 

OCTOBER 

396 . 00 

16414.64 

15723.83 

12439 . 00 

12439 .00 

NOVEMBER 

612.00 

14415.09 

13331.56 

13331.56 

DECEMBER 

739 . 00 

12973.33 

12436.62 

12436 .62 

WEIGHT 

FACTOR 

5.00 

1.50 

1.00 

ANNUAL 

AVERAGE 

505.75 

16635,46 

13481.11 

11545.37 

Q 

IN  CUBIC 

FEET  PER  SECOND,  WUA  IN 

SQUARE  FEET 

PER  1000  FEET 

Fig.  3.7.  Sample  output  from  the  HABOUT  program. 
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HBOUTA  Program 


Introduction 

The  HBOUTA  program  writes  the  data  from  a  habitat 
area-versus-streamflow  (ZHAQF)  file  into  a  format  that 
may  be  useful  for  report  purposes. 


cpWERt  ntOM  to  wEtRic.a  toti  wo  cowvsrsicw. 

Enter  1  if  you  want  the  output  printed  in  metric  units 
instead  of  English  (meters  instead  of  feet). 

JEWTER  1  TOR  WJA  PRINTED  XX. XX,  2  TOR  WOA  PRINTED  XX. 


Running  HBOUTA 


Weighted  usable  area  (WUA)  and  flow  (Q)  can  be 
printed  in  the  output  with  or  without  a  decimal  point. 


RHBOUTA,  ZHAQF,  ZOUT 

ZHAQF  =  Habitat-versus-flow  file  (input). 
ZOUT  =  HBOUTA  results  (output). 

ZHAQF  file  used  ag  Input  to  HBOX7TA: 

SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

RAINBOW  TROUT 


DISCHARGE 

PRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220,00 

5780 . 00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410 . 00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140,00 

9410.00 

350.00 

18050.00 

14110.00 

10400 . 00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470,00 

16360.00 

13660.00 

600.00 

11030,00 

14610.00 

13380 . 00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270.00 

8880.00 

1500.00 

6940.00 

8490.00 

7620 . 00 

2000.00 

7210,00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890 . 00 

9670 . 00 

mmft  1  TOR  0  PRINTED  XX. XX,  ^  TOR  PRINTED  XX. 
ENTER  1  FOR  A  BINDING  EDGE,  2  FOR  NO  BINDING  EDGE. 


The  binding  edge  is  on  the  top  of  the  paper. 
If  1  is  entered  for  a  binding  edge. 


HOW  MANY  LINES  FOR  BINDING  EDGE 


ENTER  X  TO  PRINT  UNITS  BELOW  TABLE,  2  FOR  NO  PRINT  OF  OWITS. 

If  1  is  entered,  the  following  will  be  printed  below  each 
table,  depending  on  whether  English  or  metric  units  are  used: 

Q  IN  CUBIC  FEET  PER  SECOND,  WUA  IN  SQUARE 
FEET  PER  1,000 

Q  IN  CUBIC  METERS  PER  SECOND,  WUA  IN 
SQUARE  METERS  PER  1,000  METERS 

Figure  3.8  contains  sample  output  from  the  HBOUTA 
program. 


OutDUt  from  HBOUTA; 

90/05/02. 

SNOQUALMIE  RIVER 

11.15.36. 

NEAR  SNOQUALMIE  FALLS,  WA 

PROGRAM  -  HBOUTA 
PAGE  -  2 


Q  VS.  AVAILABLE  HABITAT  AREA  PER  1000  FEET  OF  STREAM  FOR  RAINBOW  TROUT 


Q  FRY  JUVENILE  ADULT 


1 

10.00 

20570.00 

8220.00 

5780.00 

2 

100.00 

15400.00 

4770.00 

3200.00 

3 

150.00 

18880.00 

7230.00 

4890.00 

4 

200.00 

19790.00 

9360.00 

6410.00 

5 

250.00 

19780.00 

11470.00 

8020.00 

6 

300.00 

19110.00 

13140.00 

9410.00 

7 

350 . 00 

18050.00 

14110.00 

10400.00 

8 

400.00 

16290.00 

15850.00 

12600.00 

9 

500.00 

14470.00 

16360.00 

13660.00 

10 

600.00 

11030.00 

14610.00 

13380,00 

11 

800.00 

9090.00 

12310.00 

11740,00 

12 

1000.00 

7410.00 

9270.00 

8880.00 

13 

1500.00 

6940.00 

8490.00 

7620.00 

14 

2000.00 

7210.00 

8630,00 

7810.00 

15 

4000.00 

6660.00 

9480.00 

8510.00 

16 

6000.00 

5740,00 

9890.00 

9670.00 

0  IN  CUBIC  FEET  PER  SECOND,  WUA  IN  SQUARE  FEET  PER  1000  FEET 


Fig.  3. 8.  Sample  output  from  the  HBOUTA  program. 
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HAQINT  Program 


Introduction 

The  HAQINT  program  uses  a  given  habitat  area-versus- 
streamflow  (ZHAQF)  file  to  estimate  habitat  for  different 
flows  by  interpolation.  This  program  is  most  useful  when 
only  a  few  discharge  values  are  to  be  converted  to  habitat 
values,  and  it  is  especially  useful  in  conjunction  with 
HABOUT. 

Running  HAQINT 

RHAQINT,  ZHAQFN,  ZHAQF 

ZHAQFN  *  Habitat-versus-flow  file  for  requested 
flows  (output). 

ZHAQF  *  Habitat-versus-flow  file  (input). 

The  two  title  lines  from  the  ZHAQF  file  are  displayed. 

EffTfiR  1  for  ntLg.O  TO  05E  TITLE  FROM  ZHAQF  FILEr _ _ 


If  1  is  entered, 

ENTER  0  FOR  CUBIC  SPUME  INTERPOLATION,  OR 

1  F<m  LINEAR  INTERPOLATION  BETWEEN  NEAREST  FLOWS! _ 


If  0  is  entered  for  cubic  spline  interpolation,  flows  must 
be  within  the  range  of  flows  that  are  on  the  original 
ZHAQF  file. 

If  1  is  entered  for  linear  interpolation  between  nearest 
flows,  and  the  requested  flows  are  out  of  range  of  flows 
that  are  on  the  original  ZHAQF  file,  the  two  nearest  flows 
are  used  in  interpolation — therefore,  the  values  interpo¬ 
lated  may  not  be  accurate.  If  the  points  are  too  far  apart. 


consider  redoing  the  PHABSIM  analysis  using  more 
points  to  define  the  habitat  area-versus-streamflow 
function. 

Figure  3.9  contains  sample  output  from  the  HAQINT 
program. 

ZHAQF  file  used  aa  Input  to  HAQINT; 

SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

10400.00 

350.00 

18050.00 

14110.00 

12600.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270.00 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000.00 

7210.00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

*************** 

Output 

ZHAQF  file 

from  HAQINT: 

HABITAT 

AREA  VS.  ! 

STREAMFLOW  FILE  USED  TO 

CREATE 

SAMPLE 

OUTPUT  FOR 

HABOUT  PROGRAM 

RAINBOW 

TROUT 

DISCHARGE 

FRY 

JUVENILE 

ADULT 

»  1 

396.00 

16414.64 

15723 . 83 

12439 . 00 

*  2 

612.00 

10689.15 

14415.09 

13331.56 

*  3 

739 . 00 

9241.37 

12973.33 

12436.62 

*  4 

662.00 

9737 .56 

13750.97 

13064.51 

*  5 

480.00 

14874.45 

16565.80 

13710.09 

*  6 

470.00 

15031.40 

16626.67 

13716 .62 

*  7 

576.00 

11845,63 

15043.45 

13460.64 

*  8 

761.00 

9193.95 

12752.77 

12206.36 

*  9 

686 . 00 

9492.07 

13492.07 

12897.74 

*10 

324 . 00 

18687  .79 

13577.89 

9799.84 

*11 

145.00 

18617 .17 

6979.73 

4715.70 

*12 

218.00 

19838.54 

10117  .76 

6973.32 

Fig.  3.9.  Sample  output  from  the  HAQINT  program.  Cubic 
spline  interpolation  was  used. 
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LPTHQF  Program 


Introduction 

The  LPTHQF  program  plots  the  habitat  area-versus- 
streamflow  functions — 1  species  per  page;  1-5  life  stages. 

Running  LPTHQF 

RLPTHQF,  ZHAQF,  ZOUT 

ZHAQF  *  Habitat-versus-flow  file  (input). 
ZOUT*  LPTHQF  results  (output). 


Figure  3.10  contains  sample  output  from  the  LPTHQF 
program.  A  character  graph  and  a  screen  graph  are  both 
included  in  this  output.  For  all  programs  that  generate 
graphs  on  the  microcomputer,  the  user  has  the  option  to 
display  the  graphs  on  the  screen  or  write  them  to  the  output 
file  using  character  graphics  (132  characters-per-line 
format).  To  use  screen  graphics,  the  computer  must  have 
a  Color  Graphics  Adaptor  (CGA)  or  compatible  graph¬ 
ics  card.  When  using  screen  graphics,  notes  are  written 
to  the  output  file  in  the  positions  where  the  graphs  would 
have  been  placed  had  they  been  written  using  character 
graphics. 


DATE  -  90/05/01.  SNOQUALMIE  RIVER 

TIME  '  11.01.23.  NEAR  SNOQUALMIE  FALLS,  WA 

PLOTTING  EACH  LIFE  STAGE  OF  -- 


PROGRAM  -  LPTHQF 
PAGE  -  1 


RAINBOW  TROUT 

A  FRY 

B  JUVENILE 

C  ADULT 

D 
E 


Q 

A 

B 

C 

*  1 

10.00 

20570.00 

8220.00 

5780.00 

*  2 

100.00 

15400.00 

4770 . 00 

3200.00 

*  3 

150.00 

18880.00 

7230.00 

4890.00 

*  4 

200.00 

19790.00 

9360.00 

6410.00 

*  5 

250.00 

19780.00 

11470.00 

8020.00 

*  6 

300.00 

19110.00 

13140.00 

9410.00 

*  7 

350.00 

18050.00 

14110. 00 

10400.00 

*  8 

400.00 

16290.00 

15850.00 

12600.00 

*  9 

500.00 

14470.00 

16360.00 

13660.00 

*10 

600.00 

11030.00 

14610.00 

13380.00 

*11 

800.00 

9090.00 

12310.00 

11740.00 

*12 

1000.00 

7410.00 

9270.00 

8880.00 

*13 

1500.00 

6940.00 

8490.00 

7620.00 

*14 

2000.00 

7210.00 

8630.00 

7810.00 

*15 

4000.00 

6660.00 

9480 . 00 

8510.00 

*16 

6000.00 

5740 . 00 

9890.00 

9670 . 00 

Fig.  3.10.  Sample  output  from  the  LPTHQF  program. 
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DATE  -  90/05/01.  SNOQUALMIE  RIVER 

TIME  -  11.01.23.  NEAR  SNOQUALMIE  FALLS,  WA 


PROGRAM  -  LPTHQF 
PAGE  -  1 


20570. 

18513. 

16456. 

14399. 

12342. 

HABITAT 

10285. 

8228.0 

6171.0 

4114.0 

2057.0 


A===  =  =  =  =  =  =  =  =  =  :=  = 
#  1 

#  AA  1 

#  1 

#  A  A 

#  - 

#  A 

# 

# 

# 

#— -  AB 

#  B 

# 

#  A 

#  B 

#  -  A 

#  B 

#  C  C 

#  B 

#  C 

#  -  B 

#  C 

#  B 

#  A 

# 

#  - C 

# 

#  B  C 

#  A 

# 

B - 

#  C 

#  B 

# 

#  C 

#  - 

c 

# 

#  BC 

# 

# - 

# 

#  c 

# 

# 

# 

#  1 

#  1 

#  1 


O.OOOOOE-01  ========:===:==== 

O.OOOOOE-01 

600.00 


1111 

1111 

1111 


B 

c 

B  B 

C  C 

A  A 

A 


1111 

1111 

1111 


1200.0  2400.0 

1800.0  3000.0 


1  1 
1  1 
1  1 


B 

C 


A 


1  1 
1  1 
1  1 


3600.0 

4200.0 


1 

1 

1 


1 

1 

1 


4800.0 


1  # 

1  # 

1  # 

# 

-—I 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

- # 

# 

# 

# 

# 

- # 

C 

# 

# 

# 

- # 

# 

# 

# 

# 

A 

# 

# 

I 

- # 

# 

I 

# 

# 

1  I 

1  # 

1  # 


6000.0 

5400.0 


DISCHARGE 


RAINBOW  TROUT 


Fig.  3.10.  Continued 
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MRGHQF  Program 


Introduction 

The  MRGHQF  program  extracts  up  to  five  life  stages  from 
one  or  two  habitat  area-versus-streamflow  files  and  creates 
a  new  habitat  area-versus-streamflow  file. 

In  some  situations,  the  various  life  stages  for  a  single 
species  can  be  scattered  throughout  a  number  of  ZHAQF 
files.  The  cause  may  be  any  number  of  reasons — for  exam¬ 
ple,  conditional  cover  was  used  in  the  analysis;  different 
options  were  used  in  the  habitat  simulation;  or  a  mixture  of 
curve  set  ID  numbers  were  used  in  the  species  criteria  file, 
which  caused  the  habitat  programs  to  split  the  life  stages  into 
two  parts.  In  this  situation,  the  MRGHQF  program  could  be 
used  to  merge  results  from  various  sources  into  a  single  file 
for  use  in  the  time  series  analysis. 

Another  use  of  the  MRGHQF  program  is  to  compare  the 
same  life  stage  for  a  number  of  species,  in  which  case  the 
life  stage  be^mes  the  new  “species’*  and  the  species  be¬ 
comes  the  new  “life  stage”  in  the  ZHAQF  file. 


ENTER  NUMBER  CE  LIFE  STAGE  (3)  TO  EXTRACT  FROM  SET  %: 

ENTER  COLUMN  NUMBERS  CORRESPONDING  TO  LIFE  STAGERS)  FOR 
1  —  1  LIFE  STAGE  ^ _ 


The  blank  will  contain  the  number  entered  for  the  num¬ 
ber  of  life  stage(s)  to  extract  from  set  1.  For  example,  the 
following  was  displayed  for  set  1: 


****'*’««***  ******** 

DATA  SET  1  IS 
SPECIES  -RAINBOW  TROUT 

LIFE  STAGE  -  FRY  JUVENILE  ADULT 

ENTER  NUMBER  OF  LIFE  STAGE (S)  TO  EXTRACT  FROM  SET  I;  2 
ENTER  COLUMN  NUMBERS  CORRESPONDING  TO  ttFE  STAGE  (S)  FOR 
_ ■,:2  LIFE  STAGE (S)  : 


If  only  one  ZHAQF  file  was  specified  as  input,  and  1  and 
3  are  entered  here,  a  new  ZHAQF  file  will  be  created 
containing  weighted  usable  area  versus  flow  for  fry  and  adult 
rainbow  trout. 


Running  MRGHQF 

First  ZHAQF  file  need  aa  input  to  MRGHQF; 


RMRGHQF,  ZHAQFN,  ZHAQF,  ZHAQF2 

ZHAQFN  =  Habitat-versus-flow  file  with  selected 
life  stages  (output). 

ZHAQF  =  Habitat-versus-flow  file  (input). 
ZHAQF2  *  Habitat-versus-flow  file  (input). 

The  number  and  magnitude  of  flows  must  be  the  same 
on  the  ZHAQF  files  being  merged.  If  they  are  not  the 
same,  a  message  will  be  printed  and  the  program  will 
terminate. 


The  two  title  lines  from  the  input  file(s)  are  displayed. 


ENTER?  1  TO  USE  THE  TITLE  FR<»1  THE  FIRST  INPUT  FILE/- 

2  TO  USE  THE  TITLE  FRCM  THE  SECOND  INPUT  FILE  ' 

3  TO  ENTER  A  NEW  TITLE: 

ENTER  TWO  LINE  TITLE; _ 


These  title  lines  will  be  in  the  merged  output  file. 


The  following  prompts  will  appear  for  each  species 
record  in  the  ZHAQF  file(s).  Records  are  separated  by 
a  line  of  at  least  10  asterisks  (**★*****★*) 


The  Species  and  Life  Stage  lines  for  the  first  record  in 
the  input  file(s)  will  be  displayed. 


SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

9410.00 

350 . 00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600,00 

11030.00 

14610.00 

13380.00 

eoo.oo 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270 .00 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000,00 

7210.00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

Second  ZHAQF  flic  Uflod  aa  Input  to  MRGHQF: 

SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  PALLS,  WA 


SAMPLE  ZHAQF  FILE 
RAINBOW  TROUT 

TO  USE  WITH 

THE  MRGHQF 

PROGRAM. 

DISCHARGE 

SPAWNING 

JUVENILE 

ADULT 

10.00 

2050.00 

822.00 

578.00 

100.00 

1540.00 

477.00 

320.00 

150.00 

1888.00 

723.00 

489.00 

200.00 

1979.00 

936.00 

641.00 

250.00 

1978.00 

1147.00 

802.00 

300.00 

1911.00 

1314.00 

941.00 

350.00 

1805.00 

1411.00 

1040.00 

400 . 00 

1629.00 

1585.00 

1260.00 

500.00 

1447.00 

1636.00 

1366.00 

600.00 

1103.00 

1461.00 

1338.00 

800.00 

909.00 

1231.00 

1174.00 

1000.00 

741.00 

927.00 

888.00 

1500.00 

694.00 

849.00 

762.00 

2000.00 

721.00 

863.00 

781.00 

4000.00 

666.00 

948.00 

851.00 

6000.00 

574.00 

989.00 

967.00 

Fig.  3.11.  Sample  input  files  to  MRGHQF. 
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If  two  ZHAQF  files  were  specified  as  input,  the  informa¬ 
tion  in  the  example  would  be  displayed  for  both  data  sets, 
and  the  user  would  specify  what  life  stages  to  extract  fiom 
each  data  set. 


If  the  species  names  do  not  match  on  the  two  ZHAQF 
files,  then  the  following  prompt  will  be  asked: 


ENTER  NEW  SPECIES  NAME  {40  CKARS> ♦  OR  ‘ TO 
•mr-SPSOIES-'»iSH£-'-|^OM--^ 

This  name  will  be  the  first  line  in  each  record  (for  the 
first  record  in  the  ZHAQF  file,  it  follows  the  two  title 
lines). 


If  the  life  stage  names  do  not  not  match  on  the  two 
ZHAQF  files,  then  the  following  prompt  will  be  asked: 


ENTER  I— I  LIFE  STAGE  NAMB(S^  FOR  SET  Is 

(OR  TO  ysE  tlPE  STAOE  FROM  SET  a  (io  CRArS  MAXJ 


The  blank  will  contain  the  number  of  life  stage(s)  speci¬ 
fied  to  extract  from  set  1.  If  new  life  stage  names  are  being 
entered,  separate  the  names  with  a  carriage  return. 


If  two  input  files  were  specified: 


ENTER  }  LIFE  STAGE  NAMB{S>  FOR  SET  2\ 

(OR  TO  USE  l.tFE  STAGE  FROM  SET  2  (10  CHARS  MAX) 


Figure  3.11  contains  two  sample  input  files  for  the 
MRGHQF  program.  Figure  3.12  contains  sample  output 
from  the  MRGHQF  program. 


Fry,  juvenile,  and  adult  from  first  ZHAQF  file;  spawning  from  second  ZHAQF  file: 

ZHAQF  FILE  CREATED  BY  MRGHQF.  (FRY,  JUVENILE,  AND  ADULT  FROM  FIRST  ZHAQF  FILE) 
(SPAWNING  FROM  SECOND  ZHAQF  FILE) 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

SPAWNING 

*  1 

10.00 

20570.00 

8220.00 

5780.00 

2050.00 

*  2 

100.00 

15400.00 

4770.00 

3200.00 

1540.00 

*  3 

150.00 

18880.00 

7230.00 

4890.00 

1888.00 

*  4 

200.00 

19790.00 

9360.00 

6410.00 

1979.00 

*  5 

250.00 

19780.00 

11470.00 

8020.00 

1978.00 

*  6 

300.00 

19110.00 

13140.00 

9410.00 

1911.00 

*  7 

350.00 

18050.00 

14110.00 

10400.00 

1805.00 

*  8 

400.00 

16290.00 

15850.00 

12600.00 

1629.00 

*  9 

500.00 

14470.00 

16360.00 

13660 . 00 

1447.00 

*10 

600.00 

11030.00 

14610.00 

13380.00 

1103.00 

*11 

800.00 

9090.00 

12310.00 

11740 . 00 

909.00 

*12 

1000.00 

7410.00 

9270.00 

8880.00 

741.00 

*13 

1500.00 

6940.00 

8490.00 

7620.00 

694.00 

*14 

2000.00 

7210.00 

8630.00 

7810.00 

721.00 

*15 

4000.00 

6660.00 

9480.00 

8510.00 

666.00 

*16 

6000.00 

5740.00 

9890.00 

9670.00 

574.00 

Fry  and  adult  from  first  ZHAQF  file;  epaiming  and  juvenile  from  second  ZHAQF  file: 

ZHAQF  FILE  CREATED  BY  MRGHQF.  (FRY  AND  ADULT  FROM  FIRST  ZHAQF  FILE) 

(SPAWNING  AND  JUVENILE  FROM  SECOND  ZHAQF  FILE) 

RAINBOW  TROUT 


DISCHARGE 

FRY 

ADULT 

SPAWNING 

JUVENILE 

*  1 

10.00 

20570.00 

5780.00 

2050.00 

822.00 

*  2 

100.00 

15400.00 

3200.00 

1540.00 

477.00 

*  3 

150.00 

18880.00 

4890.00 

1888.00 

723.00 

*  4 

200.00 

19790.00 

6410.00 

1979 . 00 

936 .00 

*  5 

250.00 

19780.00 

8020.00 

1978.00 

1147.00 

*  6 

300.00 

19110.00 

9410.00 

1911.00 

1314.00 

*  7 

350.00 

18050.00 

10400.00 

1805.00 

1411.00 

*  8 

400.00 

16290.00 

12600.00 

1629.00 

1585.00 

*  9 

500.00 

14470.00 

13660.00 

1447.00 

1636.00 

*10 

600.00 

11030.00 

13380.00 

1103.00 

1461.00 

*11 

800.00 

9090.00 

11740.00 

909 . 00 

1231.00 

*12 

1000.00 

7410.00 

8880.00 

741.00 

927 .00 

*13 

1500.00 

6940.00 

7620.00 

694.00 

849.00 

*14 

2000.00 

7210.00 

7810.00 

721.00 

863.00 

*15 

4000.00 

6660.00 

8510.00 

666.00 

948.00 

*16 

6000,00 

5740.00 

9670.00 

574.00 

989.00 

Fig.  3.12,  Sample  output  from  the  MRGHQF  program. 
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MULHQF  Program 

Introduction 

The  MUUIQF  program  weights  individual  life  stages, 
or  multiplies  or  divides  habitat  values  in  a  habitat  area- 
versus-streamflow  file  by  a  constant. 

This  program  is  useful  when  the  habitat  area-versus- 
streamflow  functitm  needs  to  be  modified  by  a  constant. 
For  example,  an  analyst  may  wish  to  adjust  the  function  to 
account  for  a  constant  temperature  suitability  term  for  all 
flows.  Another  situation  where  the  habitat  area-versus- 
streamflow  function  could  be  modified  by  a  constant  is 
when  either  (or  both)  the  habitat  area  or  discharge  is  scaled 
to  move  the  function  to  a  new  site.  The  multiplier  (or 
divisor)  must  be  determined  by  the  analyst. 

A  third  case  where  the  MULHQF  program  would  be 
useful  is  where  each  life  stage  is  to  be  adjusted  to  an  adult 
(or  some  other)  equivalent.  An  example  of  this  function  is 
contained  in  Fig.  3.13. 


Running  MULHQF 

RMULHQF,  ZHAQFN,  ZHAQF 

ZHAQFN  *  Habitat-versus-flow  file  with  adjusted 
habitat  values  (output). 

ZHAQF  *  Habitat-versus-flow  file  (input). 

The  two  title  lines  from  the  original  ZHAQF  are  dis¬ 
played  and  the  user  is  prompted  to  enter  two  new  title  lines. 


lUfTES  0  TO  MOLTIPLY  BY  A  CCWSTAWT 

1  TO  DIVIDE  BY  A  CONSTANT 

2  TO  MULTIPLY  INDIVIDUAL  LIFE  STAGES 
BY  A  CONSTANT: 


If  options  0  or  1  are  selected: 


Enter  constant  multiplIbr/di visor  for  area  ^ 

ENTER  CONSTANT  MULTIPLIRR/DIVTSOR  FOR  DISCHARGE  >- 


ZHAQF  file  uped  Qg  loput  tg  tlPLHQg; 


SNOQUALMIE  RIVER 
NEAR  SNOQUALMIE  FALLS, 
RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410,00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

9410.00 

350.00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270.00 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000.00 

7210.00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

Output  ZHAQF  file 

from  MULHQF; 

:  The  following  weight! 

1.5 

for  Juvenile, 

and  1  for  Adult. 

ZHAQF  OUTPUT  FILE 

FROM  MULHQF 

WHEN  MULTIPLY  INDIVIDt 

CONSTANT  OPTION  WAS  SELECTED. 

WEIGHTS =  5 

FOR  FRY,  ] 

RAINBOW  TROUT 

DISCHARGE 

FRY 

JUVENILE 

ADULT 

*  1 

10.00 

102850.00 

12330.00 

5780.00 

*  2 

100.00 

77000.00 

7155.00 

3200.00 

*  3 

150.00 

94400.00 

10845.00 

4890.00 

*  4 

200 . 00 

99950.00 

14040.00 

6410.00 

*  5 

250.00 

98900.00 

17205.00 

8020.00 

*  6 

300.00 

95550.00 

19710.00 

9410.00 

*  7 

350 . 00 

90250.00 

21165.00 

10400.00 

*  8 

400.00 

81450.00 

23775.00 

12600,00 

*  9 

500.00 

72350.00 

24540.00 

13660.00 

*10 

600.00 

55150.00 

21915,00 

13380.00 

*11 

800.00 

45450.00 

18465.00 

11740.00 

*12 

1000.00 

37050.00 

13905,00 

8880.00 

*13 

1500.00 

34700.00 

12735.00 

7620.00 

*14 

2000 . 00 

36050.00 

12945.00 

7810.00 

*15 

4000.00 

33300.00 

14220.00 

8510.00 

*16 

6000.00 

28700.00 

14835.00 

9670.00 

Fig.  3.13.  Sample  output  from  the  MULHQF  program. 
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The  area  and  discharge  figures  for  each  species  record 
in  the  ZHAQF  file  will  be  multiplied  or  divided  by  the 
same  number. 

If  option  2  is  selected: 


The  following  prompt  will  appear  for  each  species 
record  in  the  ZHAQF  file.  Records  are  separated  by  a 
line  of  at  least  10  asterisks  (****★*★***). 


ENTER  WEIGHTS  FOR  EACH  LIFE  STAGE  OF 
. tspeciea  line  information] 

[life  Btage  information] 


Example: 


ENTER  WEIGHTS  FOR  EACH  LIFE  STAGE  OF 

RAINBOW  mm 

mt  OfOVENItE  ADULT 


Responses  may  be  separated  by  a  space,  comma,  or 
carriage  return. 

If  the  first  record  in  the  ZHAQF  file  contains  Total  area,  the 
species  would  be  total  area  and  the  life  stage  wotild  be  area . 

Figure  3. 13  is  an  example  of  adjusting  each  life  stage  to 
an  adult  equivalent.  The  life  stage  weights  entered  were  5 
for  fry,  1.5  for  juvenile,  and  1.0  for  adult.  This  is  to  say 
that  each  unit  of  juvenile  habitat  produces  enough  to  fill 
one  unit  of  adult  habitat. 
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NRMHQF  Program 


Introduction 

The  NRMHQF  program  normalizes  habitat  values  in  a 
habitat  area-versus-streamflow  file  regarding  a  given  dis¬ 
charge  and  the  corresponding  area.  If  the  given  discharge 
is  not  on  the  Hie,  it  will  be  added,  and  habitat  values  will 
be  calculated  by  interpolation  for  the  discharge.  If  the  first 
record  in  the  input  file  is  not  area,  the  user  will  be  prompted 
to  enter  area. 

This  program  is  useful  for  moving  habitat  area-versus- 
streamflow  functions  about  a  watershed.  The  normaliza¬ 
tion  of  the  habitat  area-versus-streamflow  function  re¬ 
quires  some  logic  from  the  analyst  to  use  normalization  to 
move  a  habitat  area-versus-streamflow  function. 

Running  NRMHQF 

RNRMHQF,  ZHAQFN,  ZHAQF 

ZHAQFN  “  Normalized  habilat-versus-flow  file  (out¬ 
put). 

ZHAQF  “  Habitat-versus-flow  file  (input). 

The  two  title  lines  from  the  ZHAQF  file  are  displayed. 


BHTER  I  to  CHAMOK  TtTtB 
' _ 0  TO  USKW  TITLE  IT  tSa 


If  1  is  entered  to  change  title; 

mm.  2  mi  tims  cms  hax)  ? 
rnttu  ytow; _ 


In  the  sample  output  in  Fig.  3.14,  the  mean  annual  flow 
and  the  surface  area  at  the  mean  annual  flow  were  used 
(499  cfs  and  275,800  ft^/  1,000  ft — average  width  of  276 
feet.) 

If  the  discharge  entered  is  not  in  the  ZHAQF  file,  it  will 
be  added,  and  habitat  values  will  be  calculated  by  interpo¬ 
lation  for  the  discharge. 


If  Total  area  is  not  the  first  record  in  the  ZHAQF  file, 
the  following  prompt  will  appear: 


TOTAL  AREA  CORRESPONDIMO  TO  HORMALIZATXO«  PLOW: 


Since  total  area  was  not  included  in  the  sample  input  file, 
275,800  was  entered  as  it  was  the  surface  area  at  the  mean 
annual  flow  of  499  cfs. 


NRMHQF  Prcxjram 
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ZHAQP  FILE  P3ED  M  INPUT  TO  NBMHOP; 

SNOgUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140 . 00 

9410.00 

350.00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270 . 00 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000.00 

7210.00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

*************** 


OUTPUT  FROM  NRMHQF:  Normalization  flow  of  499  cfs  with  a  corresponding  total 
area  of  275,000  ft^/1000  ft. 

SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS,  WA  NORMALIZED  ZHAQF  FILE 
(499 “NORMALIZATION  FLOW;  275800=TOTAL  AREA  CORRESPONDING  TO  FLOW  OF  499  CFS) 


RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

*  1 

0.02 

0 . 07 

0.03 

0.02 

*  2 

0.20 

0.06 

0.02 

0.01 

*  3 

0.30 

0.07 

0.03 

0.02 

*  4 

0.40 

0 . 07 

0.03 

0.02 

*  5 

0.50 

0.07 

0.04 

0.03 

*  6 

0.60 

0.07 

0.05 

0.03 

*  7 

0.70 

0.07 

0.05 

0.04 

*  8 

0.80 

0.06 

0.06 

0.05 

*  9 

1.00 

0.05 

0.06 

0.05 

*10 

1.00 

0 . 05 

0.06 

0.05 

*11 

1.20 

0.04 

0.05 

0.05 

*12 

1.60 

0.03 

0 . 04 

0.04 

*13 

2.00 

0 . 03 

0.03 

0.03 

*14 

3.01 

0.03 

0.03 

0.03 

*15 

4.01 

0.03 

0.03 

0.03 

*16 

8.02 

0.02 

0.03 

0.03 

*17 

12.02 

0.02 

0.04 

0.04 

Fig-  3.14.  Sample  output  from  the  NRMHQF  file. 
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SUMHQF  Program 


Introduction 

The  SUMHQF  program  sums  conditional  cover  col¬ 
umns  in  a  ZHAQF  file  into  one  habitat  area-versus- 
streamflow  figure  for  each  life  stage.  SUMHQF  is  run 
when  conditional  cover  curves  were  used  as  input  to  the 
habitat  simulation  programs.  Up  to  five  life  stages  can  be 
grouped  in  each  record  (section). 


Running  SUMHQF 

RSUMHQF,  ZHAQF,  ZHAQFN 

ZHAQF  =  Habitat-versus-flow  file  (input). 

ZHAQFN  =  Modified  habitat-versus-flow  file  with 
columns  summed  (output). 

Figure  3. 15  contains  a  habitat-versus-flow  (ZHAQF)  file 
that  was  generated  by  a  habitat  simulation  program  using 
conditional  cover  curves  as  input. 

The  results  of  running  SUMHQF  on  this  file  and  sum¬ 
ming  the  life  stages  and  grouping  the  life  stages  together 
is  shown  in  Fig.  3. 16. 

The  species  and  life  stage  lines  for  the  first  record  in  the 
ZHAQF  file  are  printed  out.  If  the  first  record  in  the  file 
contains  total  area  information,  that  record  is  skipped,  as 
there  is  nothing  to  sum  and  no  other  information  should  be 
grouped  with  it. 


Example: 


5FBC1E5  HftMfi  tS;  WtNTBR  FRV 

LtF£  NAME  1$;  liO  CQV  oHC  OBJ  Ui  OBJ  OOM^ 

VO  you  WANT  TO  SUM  THESE  LIFE 
0)  TO  3DM  LIFE  STAGES 
1)  TO  LEAVE  UNCHANGED 
Choice: 


If  0  is  entered  to  sum  life  stages — 

ENTER  NEW  SPECIES  NAME  OR  TO  LEAVE  UNCHANGED  (MAX  CHAU)  ; 

In  this  case,  you  would  probably  want  to  change  the 
species  name  to  “Winter  steelhead”  versus  “Winter  steel- 
head — ^fiy”. 

ENTER  NEW  LIFE  STAGE  NAME  OR  TO  USE  [  — }  :  (MAX  10  CHAR)  ; 


The  blank  would  contain  the  first  life  stage  name  from 
the  record  (NO  COV  in  example).  In  this  example,  you 
would  probably  want  to  change  the  life  stage  name  to  Fry. 


The  following  prompt  would  appear  after  the  first  spe¬ 
cies  record,  but  before  the  series  of  prompts  for  that 
record.  Records  are  separated  by  a  line  of  at  least  10 
asterisks  (*********’*?). 


DO  YOU  WANT  THIS  LIFE  STAGE  TO  BE  GROUPED 
WITH  THE  PREVIOUS  LIFE  STAGE?  (Y/N) ; 


This  allows  grouping  up  to  five  life  stages  for  one  species 
into  one  record  instead  of  having  separate  records  for  each 
life  stage  of  a  species. 
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ALTMAR  REACH  OF  SALMON  RIVER,  NEW  YORK 
COMPOSITE  OF  VELOCITIES  AND  SECTIONS  AS  ISLANDS 
TOTAL  AREA 


DISCHARGE 

AREA 

*  1 

25.00 

155830.02 

♦  2 

50.00 

177486 .70 

*  3 

100.00 

196136 .69 

*  4 

200.00 

216444.92 

*  5 

350.00 

255153.21 

*  6 

500.00 

275933 .49 

*  7 

750.00 

290595.31 

*  8 

1000.00 

299066.76 

*  9 

1500.00 

314227.33 

*10 

2000.00 

324867 .37 

*11 

3000,00 

336215.01 

*12 

4000.00 

342061.39 

*13 

6000.00 

353205.87 

*************** 

WINTER  STEELHEAD 

'  FRY 

DISCHARGE 

NO  COV 

OHC 

SM  OBJ 

LG  OBJ 

*  1 

25.00 

36804.74 

16306 .65 

.00 

21789 .52 

*  2 

50.00 

42488.03 

29452.52 

77.77 

27011.82 

*  3 

100.00 

49470.16 

52286 .84 

497.36 

36938.97 

*  4 

200.00 

57006 .86 

75435.19 

1679.59 

54869.38 

*  5 

350.00 

53623.63 

72839 .97 

11397.30 

72371.30 

*  6 

500.00 

57625.58 

80676 .66 

13611.55 

86036.53 

*  7 

750.00 

42776.20 

76005.57 

17616.62 

97044.67 

*  8 

1000.00 

44224.03 

66899.98 

17214.27 

99281.85 

*  9 

1500.00 

33173.15 

51386.66 

11574.54 

93601.19 

*10 

2000.00 

30239 . 80 

45081.72 

9715.15 

89563.80 

*11 

3000.00 

41442.36 

52683.58 

8968.61 

99457 .46 

*12 

4000.00 

40432.90 

52567 .05 

9091.70 

91380.50 

*13 

6000.00 

38948.23 

52587.85 

9177.92 

75138.07 

*************** 

WINTER  STEELHE7U3 

'  JUVENILE 

DISCHARGE 

NO  COV 

OHC 

SM  OBJ 

LG  OBJ 

*  1 

25.00 

8571.75 

8400.63 

8299 . 07 

15146 . 13 

*  2 

50.00 

9510.26 

9713.29 

10403.51 

15011.19 

*  3 

100.00 

10862.79 

12096 .84 

12639 . 01 

13434.02 

*  4 

200.00 

11115.56 

17193 .59 

13461.92 

9264.43 

*  5 

350.00 

8391.54 

20679 .94 

13209 . 33 

7143.46 

*  6 

500.00 

7582.15 

22703.33 

15003 . 20 

5988.42 

*  7 

750.00 

10476.25 

33439.54 

17078.55 

5783 .53 

*  8 

1000.00 

16027 .40 

43305.33 

18235.65 

5270.12 

*  9 

1500.00 

19676.19 

47712.90 

16389.55 

5490.25 

*10 

2000.00 

17830.52 

47498 .62 

14661.03 

4733 . 12 

*11 

3000.00 

367.64 

27747  .65 

10016,22 

1064  .70 

*12 

4000.00 

314.97 

23107 .39 

9086.60 

481.36 

*13 

6000.00 

312.27 

19566.01 

7995.55 

183.39 

*************** 

WINTER  STEELHEAD 

-  ADULT 

DISCHARGE 

NO  COV 

OHC 

SM  OBJ 

LG  OBJ 

*  1 

25.00 

43608.82 

6196  .79 

25572.92 

68915.12 

*  2 

50.00 

52224.68 

10751 .89 

30262.63 

73718.21 

*  3 

100.00 

61181.60 

16278.15 

34279.03 

72336.25 

*  4 

200.00 

66805.23 

20009.82 

35725.55 

64934 . 86 

*  5 

350.00 

70469.46 

18052.48 

39403.82 

64219 .78 

*  6 

500.00 

72489.76 

17356  .70 

42966 . 28 

64386.38 

*  7 

750.00 

70860.33 

18509  .72 

47208.83 

50221.78 

*  8 

1000.00 

64313.60 

15762.86 

48012.24 

39843.04 

*  9 

1500.00 

56186.58 

11580.82 

48662.42 

30564.08 

*10 

2000.00 

53859.44 

11422.69 

47223.98 

29356.40 

*11 

3000.00 

51531.37 

9654 .18 

42808.11 

34230.58 

*12 

4000,00 

50553.59 

9889.69 

41964.97 

33305.82 

*13 

6000.00 

49788.69 

9994.45 

43444.38 

32462.49 

Fig.  3.15.  ZHAQF  file  generated  using  conditional  cover  curves. 


COMBO 
25244 . 11 
30049 . 86 
38996.91 
55732.63 
73694.66 
85775.26 

88448.59 
87951.39 
84916.85 

78886.59 

85294.71 

74053.72 
53160.54 


COMBO 

56589.43 

60120.13 

59780.00 

52818.65 

54584 . 10 
55091.62 
45213.51 
38723.45 
34261.80 
33701.92 
30885.99 

30155.11 
29209.57 
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ALTMAR  REACH  OF  SALMON  RIVER,  NEW  YORK 
C(»!POSITE  OF  VELOCITIES  AND  SECTIONS  AS  ISLANDS 


TOTAL  AREA 


DISCHARGE 

AREA 

*  1 

25.00 

155830.02 

*  2 

50.00 

177486.70 

*  3 

100.00 

196136.69 

*  4 

200.00 

216444.92 

*  5 

350.00 

255153.21 

*  6 

500.00 

275933.49 

*  7 

750.00 

290595.31 

*  8 

1000.00 

299066 .76 

*  9 

1500.00 

314227.33 

*10 

2000.00 

324867.37 

*11 

3000.00 

336215.01 

*12 

4000.00 

342061.39 

*13 

6000.00 

353205.87 

*************** 

WINTER  STEELHEAD 

DISCHARGE 

FRY 

JUVENILE 

ADULT 

*  1 

25.00 

100145.02 

40417.58 

200883.09 

*  2 

50.00 

129080.00 

44638.25 

227077 .53 

*  3 

100.00 

178190.23 

49032.66 

243855.03 

*  4 

200.00 

244723.64 

51035.50 

240294 . 09 

*  5 

350.00 

283926.84 

49424.27 

246729.62 

*  6 

500.00 

323725.56 

51277.10 

252290.73 

*  7 

750.00 

321891.66 

66777.87 

232014.17 

*  8 

1000.00 

315571.50 

82838.49 

206655.20 

*  9 

1500.00 

274652.37 

89268.89 

181255.70 

*10 

2000.00 

253487.06 

84723.29 

175564.44 

*11 

3000.00 

287846 .72 

39196.21 

169110.22 

*12 

4000.00 

267525.87 

32990.32 

165869 . 17 

*13 

6000.00 

229012.59 

28057.22 

164899.56 

Fig.  3.16.  ZHAQF  file  with  life  stages  simuned  using  SUMHQF. 
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Chapter  4. 

Transferring  Streamflow  Data 


Introduction 

In  many  instream  flow  investigations,  the  site  where  the 
analysis  is  desired  is  not  the  same  location  as  where  stream- 
flow  data  are  available.  Usually  it  is  the  responsibility  of  the 
project  sponsor  to  transfer  the  streamflow  data  from  the 
location  where  they  are  available  to  the  site  where  the 
instream  flow  analysis  is  desired.  In  some  situations,  the 
instream  flow  analyst  needs  to  do  the  transferral.  The  pro¬ 
grams  presented  in  this  section  will  allow  the  instream  flow 
analyst  to  make  relatively  simple  transferrals.  The  programs 
are  based  on  the  work  of  one  of  the  authors  while  working 
with  the  Washington  Department  of  Ecology.  These  pro¬ 
grams  are  relatively  simple;  users  interested  in  more  com¬ 
plex  approaches  should  contact  experts  in  the  area  or  de¬ 
velop  their  own  programs. 

The  TRANMR  and  TRANMN  programs  are  available 
to  make  approximate  estimations  of  streamflow  at  un¬ 


gaged  river  segments  (ungaged  sites)  by  transferring  data 
for  a  gaged  location.  The  TRANMR  program  uses  readily 
available  information  to  make  the  streamflow  transferal  or 
it  uses  regional  statistics  that  may  be  available  from  the 
U.S.  Geological  Survey.  The  TRANMN  program  requires 
measured  data  to  develop  a  relation  between  the  two  sites. 

The  TRANTS  program  is  available  to  investigate  the 
effect  of  longer  records  on  the  annual  flows.  In  many 
situations,  the  daily  and  monthly  flows  are  significantly 
regulated  by  humans,  but  the  annual  flows  are  reasonably 
representative  of  what  the  flows  would  be  naturally.  Ex¬ 
ceptions  to  this  are  large  dams  and  irrigation  projects. 
These  regulated  sites  are  often  the  sites  with  the  longest 
records.  Using  the  aimual  flows  at  the  longer  record  site  to 
extend  the  annual  flow  record  at  a  site  being  studied  allows 
the  analyst  to  determine  how  representative  the  available 
record  is. 


Programs  to  transfer  Streamflow  Data 


Program  BatclVPltocedure 
Name  Filename  Rmction 

TRANTS  RTRANTS  Thnsfeiring 

streamflow 

data 


_ Program  Description _ 

Tiansfers  an  annual  streamflow  file  from  a  long  record  site  to  a  short 
record  site  using  the  equation 

Qnew  -  A*(Qold)**B. 

RTRANTS,  ZANTS,  ZANTSN 


ZANTS  =  Atmual  time  series  file  containing  streamflow  data  from 
a  long  record  site  (input). 

ZANTSN  =*  Transferred  aimual  time  series  file  for  a  short  record  site 
(output). 
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Ptogram  Batch/E^rocedme 
Nams  Hlename  Rmction 

TRAP^JMN  RTRANMN  TlansfaTing 

strearaflow 

data 


_ Ptogtam  Description _ 

Thmsfers  a  monthly  streamflow  file  from  a  gaged  site  to  an  imgaged 
site  using  the  equation 

Qnew  =  A*(Qold)**B 

with  options  to  use  different  A  and  B  values  for  different  flow  ranges 
or  to  compute  A  and  B  using  given  old  and  new  flows. 

RTRANMN,  ZMONQ,  ZMONQN,  ZOUT 


ZMONQ  =  Monthly  streamflow  file  (in  USGS  or  NWDC  format) 
for  a  gaged  site  (input). 

^lONQN  «  Monthly  streamflow  file  with  calculated  flows  for  the 
ungaged  site  (output). 

ZOUT  =  TRANMN  results  (output). 

TRANMR  RTRANMR  Tiansferring  Thmsfers  a  monthly  streamflow  file  for  a  gaged  site  to  an  imgaged  site 

streamflow  using  one  of  the  following  methods:  (1)  drainage  area  ratio;  (2)  drain- 

data  age  area  and  precipitation  ratio;  or  (3)  regional  statistics  method. 

RTRANMR,  ZMONQ,  ZMONQN,  ZOUT 

ZMONQ  ==  Monthly  streamflow  file  (in  USGS  or  NWDC  format) 
for  a  gaged  site  (input). 

ZMONQN  =  Monthly  streamflow  file  with  calculated  flows  for  the 
ungaged  site  (output). 


ZOUT  =  TRANMR  results  (output). 


TRANTS  Program 
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TRANTS  Program 


Introduction 

The  TRANTS  program  is  used  to  investigate  the  effect  of 
longer  records  on  the  annual  flows.  In  many  situations,  the 
daily  and  monthly  flows  are  significantly  regulated  by  hu¬ 
mans,  but  the  annual  flows  are  reasonably  representative  of 
what  the  flows  would  be  naturally.  Exceptions  to  this  are 
large  dams  and  irrigation  projects.  These  regulated  sites  are 
often  the  sites  with  the  longest  records.  Using  the  annual 
flows  at  the  longer  record  site  to  extend  the  annual  flow 
record  at  a  site  being  studied  allows  the  analyst  to  determine 
how  representative  the  available  record  is. 


Running  TRANTS 

RTRANTS,  Z  ANTS,  Z  ANTSN 

ZANTS«  Annual  time  series  file  containing 
streamflow  data  from  a  long  record  site 
(input). 

ZANTSN  “  Tfansferred  annual  time  series  file  for  a 
short  record  site  (output). 


■  TWO  mu  TITL?  USES  FOR  WRT  RFCORO 

•  TRANTS  TRANSFERS  ANNUAL  PLOWS,  USING  THE  EQUATION 
ONEW  »  A»{QOLD)^»B 

ENTER  A  AMP  B; _ 

These  values  are  obtained  from  an  analysis  of  the  rela¬ 
tion  between  the  two  sites.  Figure  4.1  is  a  diagram  of  the 
relation  of  the  annual  streamflow  of  the  Black  River  at 
Watertown,  New  York  (long  record  site),  and  the  annual 
streamflow  at  Sandy  Creek  near  Adams,  New  York  (short 
record  site). 

In  this  analysis,  A  is  15  and  B  is  1. 

The  AQBKWAT.DAT  file  on  your  sample  disk  contains 
the  annual  streamflow  data  for  the  Black  River  at  Water- 
town,  New  York. 


Fig.  4.1.  Diagram  of  the  relation  of  the  atmual 
streamflow  of  the  Black  River  at  Water- 
town,  New  York,  and  the  annual  stream- 
flow  at  Sandy  Creek  near  Adams,  New 
York 


Annual  flow  of  Sandy  Creek 
near  Adams,  NY  (Qg) 
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TRANMN  Program 


Introduction 

The  TRANMN  program  transfers  mcaithly  flows  from  a 
gaged  (measured)  site  to  an  ungaged  site  using  the  equation 

Qnew  *  A*(Qold)**B 

with  options  to  use  different  A  and  B  values  for  different 
flow  ranges  or  to  compute  A  and  B  using  given  old  and 
new  flows. 

The  sample  output  from  the  TRANMN  program  (Figs. 
4.3  and  4.4)  was  generated  using  gaged  streamflow  data 
from  Sandy  Creek  near  Adams,  New  York,  and  transfer¬ 
ring  that  data  to  the  West  Branch  of  the  Oswegatchie  River 
near  Harrisville,  New  York,  using  two  different  options  in 
the  TRANMN  program.  The  MQSANCK.DAT  file  on 
your  sample  disk  contains  the  gaged  streamflow  data  for 
Sandy  Creek  near  Adams,  New  York. 

Running  TRANMN 

RTRANMN,  ZMONQ,  ZMONQN,  ZOUT 

ZMONQ  “  Monthly  streamflow  file  (in  USGS  or 
NWDC  format)  for  a  gaged  site  (input). 

ZMONQN  “  Monthly  streamflow  file  with  calculated 
flows  for  the  ungaged  site  (output). 

ZOUT  **  TRANMN  results  (output). 

The  two  title  lines  from  the  input  streamflow  file  will  be 
displayed. 

ENtER  TWO  TITLE  LiHEE  FOR  ONGAGED  SITE; 

ENTER  STATION  HUMBER  FOR  UWGAGED  SITE  (10  CHAR  MAX)  i  ■  ■ 

TRANMN  OSES  THE  EQUATION  C?n«w  *  A*Qold**B 

ENTER:  »  tO  ENTER  A  AND  6  FOR  ALE.  ELOWS 

1  »  TO  ENTER  OIFFSRENT  A  ANp  E  VALOES  FOR 

PTFPBREHT  RANGES  OF  PLOWS 

2  «  TO  ENTER  PAIRS  OF  OLD  AND  NEW  FLOWS  TO 

USE  TO  COMPUTE  A  AND  B.  _ 


If  option  0  is  selected: 

ENTER  A  AND  R; _ •  _ ^ _ 

Output  is  similar  to  option  1  except  that  only  one  equa¬ 
tion  is  used. 

If  option  1  is  selected: 

enter  the  number  of  flow  ranges  to  be  used  <6  MAX) : 


To  generate  the  output  in  Fig.  4.3,  ”2”  was  entered. 

Figure  4.2  is  a  diagram  showing  the  development  of  the 
relations  used  in  the  TRANMN  program. 

The  points  in  Fig.  4.2  are  from  the  daily  values  of 
streamflow  published  by  the  U.S.  Geological  Survey. 
Common  sources  for  the  ungaged  sites  are  short  records, 
miscellaneous  streamflow  measurements,  or  streamflow 
data  from  the  instream  flow  study.  One  concern  with  the 
data  shown  in  Fig.  4.2  is  that  the  best  relation  for  the 
winter  period  is  Qw  “  191  Qs  for  all  flows,  and  during 
summer,  Qw  “  22.9  Qs®*^  for  flows  less  than  560,  This 
problem  can  be  solved  by  using  the  first  equation  for  all 
flows  (option  0)  for  one  run  of  TRANMN  and  both 
equations  (option  1)  for  a  second  run.  The  SELMTS 
program  (Chapter  8)  could  then  be  used  to  merge  the  two 
files  into  one  file  with  the  months  of  November  through 
April  from  the  first  file  and  May  through  October  from 
the  second  file. 

The  user  must  develop  the  logic  of  how  to  approach  the 
problem  and  must  develop  the  transfer  equations.  For 
assistance,  see  Riggs  (1972). 

ENTER  THE  UPPER  BOUND  FOR  THE  FLOW  RANGES 

FROM  LEAST  TO  GREATEST: 


520  and  10000  were  entered. 


ENTER  A  AND  B  FOR  THE  FLOW  RANGE  FROM 
O.OOOOOOOE- 01  TO  t'-'J  ^520  in  thia  case): 


The  A  and  B  values  entered  were  22.9  and  .6. 


Renter  a  and  b  for  the  flow  range  from 

1526.0000000  TO  lOODO . 0000000  ; _ 


The  A  and  B  values  entered  were  1.91  and  1. 
If  option  2  is  selected: 

ENTER  NUMBER  OF  POINTS  TO  BE  USED  FOR  CALIBRATION: 


To  generate  the  output  in  Fig.  4.4,  “24*’  was  entered. 
The  data  used  here  are  the  same  as  shown  in  Fig.  4.2. 
Compare  Figs.  4.3  and  4.4,  both  of  which  are  based  on  the 
same  data,  but  use  a  different  approach  to  using  the  data. 
It  would  be  better  to  have  used  the  two-curves  approach 
(option  1).  The  user  must  obtain  the  data  used  in  the 
analysis  and  select  a  single  curve. 

■  ENTER  THE  t  PAI RS  IQOLD .  QNEW)  t 

ENTER  1  TO  PLOT  GIVEN  FLOW  PAIRS 
0  OTHERWISE. 


Streamflow  of  West  Branch, 
Oswegatchie  River  near 
Harrisvllle,  NY  (QJ 


TRANMN  Prcxjram 
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Fig.  42.  Diagram  of  the  relation  of  the  stream- 
flow  of  Sandy  Creek  near  Adams,  New 
York,  to  the  streamflow  of  the  West 
Branch  Oswegatchie  River  near  Harrisville, 
New  York. 


Streamflow  of  Sandy  Creek 
near  Adams,  NY  (Qg) 
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ZOOT  file  when  option  1  was  selected; 

USING  DIFFERENT  A  AND  B  VALUES  FOR  2  FLOW  RANGES 


RANGE  NUMBER 

LOWER  BOUNDARY 

UPPER  BOUNDARY 

A  VALUE 

B  VALUE 

1 

0 . 00 

520.00 

22.90 

0.60 

2 

520 . 00 

10000.00 

1.91 

1.00 

ZBJONQN  file  when  option  1  was  selected: 


TRANSFERRED  STREAMFLOW  DATA  FROM  SANDY  CREEK  NEAR  ADAMS,  NY  TO 

WEST  BRANCH  OSWEGATCHIE  RIVER  NEAR  HARRISVILLE,  NY  USING  TRANMN,  OPTION  1 


04262500 

1958 

1 

211.98 

700.37 

1135 

516.19 

388.48 

802.48 

04262500 

1958 

2 

894.04 

517  .69 

392.98 

366 .93 

462.01 

791.80 

04262500 

1959 

1 

638.76 

590.35 

446 . 15 

847  .79 

652.47 

1082 

04262500 

1959 

2 

2013 

516 .64 

266.06 

261.78 

228.45 

101.50 

04262500 

1960 

1 

374.62 

800.26 

917.70 

509 .45 

882.85 

762.92 

04262500 

1960 

2 

1921 

495.99 

543.54 

174 .19 

91.22 

52.29 

04262500 

1961 

1 

150.27 

353.34 

323.87 

309  .71 

944.51 

1302 

04262500 

1961 

2 

1357 

468.01 

433.64 

235.64 

93.50 

98.78 

04262500 

1962 

1 

182.20 

438.53 

667.77 

771.36 

455.66 

1216 

04262500 

1962 

2 

1333 

457 .38 

145.92 

150.51 

270.91 

214.93 

04262500 

1963 

1 

374.28 

455.51 

382.33 

350.00 

379.86 

1554 

04262500 

1963 

2 

2267 

746 .27 

237.64 

93.45 

163.93 

65.34 

04262500 

1964 

1 

64.10 

536.99 

594,29 

733.47 

424.95 

1524 

04262500 

1964 

2 

974.02 

523.37 

229.25 

87.84 

88.63 

63.55 

04262500 

1965 

1 

114.45 

374.58 

701.71 

454.01 

903.80 

553.57 

04262500 

1965 

2 

1182 

375.30 

182.51 

106.27 

133.78 

■  346.96 

04262500 

1966 

1 

715.43 

915.63 

993.51 

560.48 

658.85 

1384 

04262500 

1966 

2 

770.98 

360.26 

183.71 

69.82 

109.93 

223.19 

04262500 

1967 

1 

196.62 

459 .43 

1039 

800.82 

421 . 16 

451.82 

04262500 

1967 

2 

866 .70 

605.80 

215.27 

149.48 

90.73 

197.20 

04262500 

1968 

1 

653.91 

1235 

653.20 

429.86 

668 . 15 

1091 

04262500 

1968 

2 

717 .47 

511.01 

308.25 

157 .33 

77.63 

169.78 

04262500 

1969 

1 

369.56 

1150 

842.06 

811.93 

646 . 50 

764.33 

04262500 

1969 

2 

1532 

710.06 

545.43 

216.96 

116.51 

68.70 

04262500 

1970 

1 

128.85 

562.40 

655.29 

402.28 

678.57 

716.33 

04262500 

1970 

2 

1992 

608.60 

311.47 

299.45 

112.09 

139.13 

04262500 

1971 

1 

526 .68 

690.16 

601.06 

422.28 

456 . 13 

840.74 

04262500 

1971 

2 

2204 

1109 

264.72 

168.51 

198.64 

248.25 

04262500 

1972 

1 

176.35 

545.32 

832.13 

670.38 

524 . 09 

1166 

04262500 

1972 

2 

1676 

729  .77 

768.26 

900.37 

388.21 

184.57 

04262500 

1973 

1 

402.02 

805.61 

975.14 

1003 

871.96 

1081 

04262500 

1973 

2 

1090 

644  .72 

339.57 

115.20 

103.17 

136.23 

04262500 

1974 

1 

240.28 

627 .61 

1514 

891.17 

568.70 

766.94 

04262500 

1974 

2 

1447 

880.17 

336.76 

245.24 

250.32 

193.88 

04262500 

197  5 

1 

236  .74 

797.56 

841.98 

812.45 

763.28 

1203 

04262500 

197  5 

2 

1227 

402.67 

360.39 

165.92 

120.78 

644.90 

04262500 

1976 

1 

562.06 

763 . 00 

866.48 

698.45 

1753 

1933 

04262500 

1976 

2 

819.31 

1405 

627.91 

431.18 

438.40 

676.59 

04262500 

1977 

1 

1084 

754 .79 

743.63 

392.36 

493.33 

3048 

04262500 

1977 

2 

157  2 

397 .46 

185.25 

109.10 

462.72 

688.26 

04262500 

197  8 

1 

967.85 

1268 

1040 

1089 

552.06 

940.97 

04262500 

1978 

2 

2361 

511.13 

255.75 

97.32 

74.29 

207.65 

04262500 

1979 

1 

333.62 

385.91 

611.13 

898.61 

499.64 

2126 

04262500 

1979 

2 

935.58 

490.84 

255.83 

101.65 

185.76 

504.27 

04262500 

1980 

1 

760.39 

901.46 

964 . 19 

550.91 

268.33 

1290 

04262500 

1980 

2 

107  5 

445.54 

292.59 

382.20 

189.45 

257.86 

04262500 

1981 

1 

849.42 

958.98 

963.68 

370.90 

2227 

705.51 

04262500 

1981 

2 

828,72 

559.39 

300.81 

416 .47 

625.81 

659.82 

04262500 

1982 

1 

1003 

792.44 

472.74 

548.20 

412.58 

1121 

04262500 

1982 

2 

1503 

463.87 

555.71 

225.83 

199.68 

392.21 

Fig.  43.  Sample  output  when  Option  1  is  selected  in  the  TRANMN  program. 
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ZOUT  file  when  option  3  vae  eelected: 

DATE  -  90/07/18.  H  04250750  4348480760430003636045SW04140102  128.00  523.71  PROGRAM 

TIME  -  09.38.35.  N  04250750  SANDY  CREEK  NEAR  ADAMS,  N.  Y.  PAGE 

USING  FLOW  REGRESSION  BASED  ON  24  USER  DEFINED  PAIRS 


POINT 

OLD  FLOW 

NEW  FLOW 

1 

161.00 

612.00 

2 

1580.00 

425.00 

3 

118.00 

245.00 

4 

536 . 00 

1160.00 

5 

729.00 

1290.00 

6 

231.00 

433.00 

7 

327.00 

763.00 

8 

210.00 

628.00 

9 

164.00 

296.00 

10 

150.00 

292.00 

11 

194.00 

302.00 

12 

278.00 

696.00 

13 

229 . 00 

388.00 

14 

620.00 

860.00 

15 

1150.00 

1780.00 

16 

275.00 

921.00 

17 

267.00 

623.00 

18 

51.00 

216.00 

19 

21.00 

143.00 

20 

13.00 

80.00 

21 

14.00 

222.00 

22 

24 . 00 

341 . 00 

23 

33.00 

95.00 

24 

11.00 

66.00 

TITLE  OF 

GAGED  SITE  IS  - 

H  04250750  4348480760430003636045SW04140102  128.00  523.71 

N  04250750  SANDY  CREEK  NEAR  ADAMS,  N.  Y. 

TITLE  OF  UNGAGED  SITE  IS  - 

TRANSFERRED  STREAMFLOW  DATA  FROM  SANDY  CREEK  NEAR  ADAMS,  NY  TO 

WEST  BRANCH  OSWEGATCHIE  RIVER  NEAR  HARRISVILLE,  NY  USING  TRANMN- OPTION2 

THE  REGRESSION  RELATIONSHIP  IS  - 

QNEW  =  .297E+02  *  QOLD  **  0.519 

CORRELATION  COEFFICIENT  =0.8507 
STANDARD  ERROR  OF  ESTIMATE  =  0.0415 
ZMONQ  file  when  option  2  vas  selected i 


Fig.  4.4.  Sample  output  when  Option  2  is  selected  in  the  TRANMN  program. 
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ZMONQ  file  iriien  option  2  wae  eelectedi 

TRANSFERRED  STREAMFLOW  DATA  FROM  SANDY  CREEK  NEAR  ADAMS,  NY  TO 

WEST  BRANCH  OSWEGATCHIE  RIVER  NEAR  HARRISVILLE,  NY  USING  TRANMN-OPTION  2 


04262500 

1958 

1 

203.27 

571.03 

815.27 

438.66 

343.12 

642.32 

04262500 

1958 

2 

705.18 

439  .76 

346.55 

326.61 

398.58 

634.92 

04262500 

1959 

1 

527 .35 

492.63 

386  .72 

673.54 

537.12 

795.12 

04262500 

1959 

2 

1097 

438.99 

247 .38 

243.94 

216.85 

107 .56 

04262500 

1960 

1 

332.51 

640.78 

721.28 

433.71 

697.55 

614.86 

04262500 

1960 

2 

1071 

423.79 

458.68 

171.54 

98.08 

60.64 

04262500 

1961 

1 

150.99 

316 . 12 

293.20 

282.09 

739.46 

875.31 

04262500 

1961 

2 

894.42 

403.05 

377 .33 

222.74 

100.19 

105.06 

04262500 

1962 

1 

178.34 

381.01 

547  .99 

620.73 

393.84 

844.99 

04262500 

1962 

2 

886.12 

395.12 

147.20 

151.19 

251.27 

205.71 

04262500 

1963 

1 

332.25 

393.73 

338.42 

313.54 

336.53 

959.41 

04262500 

1963 

2 

1167 

603.24 

224.37 

100.14 

162.78 

73.51 

04262500 

1964 

1 

72.30 

453.90 

495.47 

594.29 

370.79 

949.96 

04262500 

1964 

2 

759.39 

443.93 

217 .51 

94.93 

95.66 

71.76 

04262500 

1965 

1 

119.33 

332.48 

571.98 

392.61 

711.83 

465.99 

04262500 

1965 

2 

832.67 

333.03 

178.61 

111.91 

136.56 

311.18 

04262500 

1966 

1 

581.63 

719.88 

760.82 

471.01 

541.66 

903.55 

04262500 

1966 

2 

620.46 

321.46 

179.62 

77.84 

115.24 

212.53 

04262500 

1967 

1 

190.47 

396.65 

778.54 

641.17 

367.93 

390.96 

04262500 

1967 

2 

686.50 

503.75 

205.99 

150.30 

97.62 

190.97 

04262500 

1968 

1 

538.15 

851.68 

537 .64 

374.48 

548.26 

798.71 

04262500 

1968 

2 

583.06 

434.86 

280.94 

157.10 

85.31 

167  .79 

04262500 

1969 

1 

328.63 

820.66 

669.60 

648 . 84 

532.87 

615.84 

04262500 

1969 

2 

952.30 

577.86 

460.06 

207.39 

121.18 

76  .76 

04262500 

1970 

1 

132 . 19 

472.40 

539 . 13 

353.63 

555.64 

582.27 

04262500 

1970 

2 

1091 

505.76 

283.48 

274.00 

117.19 

141.26 

04262500 

1971 

1 

446.35 

563.83 

500.34 

368.77 

394 . 19 

668.70 

04262500 

1971 

2 

1150 

805.57 

246.30 

166.70 

192.17 

233.00 

04262500 

1972 

1 

173.38 

459.97 

662.77 

549.84 

444.46 

826.67 

04262500 

1972 

2 

997.84 

591.70 

618.57 

709 .49 

342.91 

180.35 

04262500 

1973 

1 

353.43 

644.48 

760.14 

764.75 

690.11 

794.84 

04262500 

1973 

2 

798.42 

531.60 

305.45 

120.00 

109.09 

138 .71 

04262500 

1974 

1 

226.53 

519.39 

946.51 

703.23 

476.98 

617 .65 

04262500 

1974 

2 

924.48 

695.72 

303.26 

230.56 

234.68 

188.18 

04262500 

1975 

1 

223 .64 

638.91 

669.55 

649.20 

615.11 

840.02 

04262500 

1975 

2 

848.90 

353.92 

321.57 

164.49 

125.00 

531.73 

04262500 

1976 

1 

472.16 

614.91 

686.35 

569.69 

1021 

1074 

04262500 

1976 

2 

653.94 

910.59 

519.60 

375.48 

380.91 

554.24 

04262500 

1977 

1 

796.03 

609 . 19 

601.39 

346 . 08 

421.82 

1361 

04262500 

1977 

2 

965.33 

349.96 

180.92 

114.49 

399.10 

562.49 

04262500 

1978 

1 

755.23 

863.31 

779.16 

797 .72 

464 . 89 

737.06 

04262500 

1978 

2 

1192 

434.94 

239.07 

103.72 

82.14 

199.68 

04262500 

1979 

1 

300.81 

341.16 

507 .58 

708.29 

426.48 

1129 

04262500 

1979 

2 

733.41 

419.98 

239.14 

107 .70 

181.35 

429 . 89 

04262500 

1980 

1 

613.09 

710.24 

752.76 

464 . 05 

249.21 

871.29 

04262500 

1980 

2 

792.68 

386.26 

268.56 

338 . 32 

184.46 

240.78 

04262500 

1981 

1 

674.66 

749.24 

752.41 

329.65 

1156 

574.66 

04262500 

1981 

2 

660.43 

470.22 

275.07 

364.38 

518.10 

542.35 

04262500 

1982 

1 

764 .41 

635.37 

406.56 

462.08 

361.44 

810.09 

04262500 

1982 

2 

943.08 

399 . 96 

467.54 

214.70 

193.04 

345.97 

Fig.  4.4.  Continued. 
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TRANMR  Program 


Introduction 

The  TRANMR  program  transfers  a  monthly  stream- 
flow  file  for  a  gaged  (measured)  site  to  an  ungaged  site 
using  one  of  the  following  methods:  drainage  area  ratio, 
drainage  area  and  precipitation  ratio,  or  the  regional 
statistics  method. 

The  TRANMR  program  was  used  to  transfer  gaged 
streamflow  data  from  Sandy  Creek  near  Adams,  New 
York,  to  (1)  the  Salmon  River  between  the  Salmon  River 
Reservoir  and  Pulaski  using  the  drainage  area  ratio  only, 
and  (2)  the  Salmon  River  at  the  Salmon  River  Reservoir 
using  the  drainage  area  and  precipitation  ratio.  The 
MQSANCK.DAT  file  on  your  sample  disk  contains  the 
gaged  streamflow  data  for  Sandy  Creek  near  Adams, 
New  York.  Figure  4.5  contains  sample  output  from  the 
TRANMR  program. 

The  following  data  is  needed  to  do  the  streamflow 
transferrals. 

Sandy  Creek  near  Adams,  New  York: 

Drainage  area:  128  square  miles 

Precipitation:  40  inches 

Salmon  River  between  Salmon  River  Reservoir  and 
Pulaski: 

Drainage  area:  66  square  miles 
Salmon  River  at  Salmon  River  Reservoir: 

Drainage  area:  191  square  miles 

Precipitation:  52  inches 


Running  TRANMR 

RTRANMR,  ZMONQ,  ZMONQN,  ZOUT 

ZMONQ  =  Monthly  streamflow  file  (in  USGS  or 
NWDC  format)  for  a  gaged  site  (input). 

ZMONQN  *  Monthly  streamflow  file  with  calculated 
flows  for  an  ungaged  section  of  stream 
(output). 

ZOUT  “  TRANMR  results  (output). 


ENTJES  X  TO  USE  DRAI«AGE  AREA  BAtIO  ONLV 

2  TO  USE  OBAiNAGE  AREA  AND  PREGIPITATIOK  RATIO 
_ 3  TO  USE  THE  REGIONAL  STATISTICS  MBTHOC 


The  two  title  lines  from  the  input  streamflow  file  will  be 
displayed. 

ENTER  TWO  TITLE  LINES  FOR  UMGAGED  SITE: 

ENTER  STATION  NUMBER  FOR  ONGAGED  SITE  <10  CHAR  MAX^ : 

ENTER  msnm  index  for  first  month  op  each  yeah 
(JAN.*1.  OCT.«10,  ETC.)  t _ 


This  labels  the  first  month  on  the  input  data  set — ^for 
example,  if  the  data  in  the  input  file  is  in  water  years 
(beginning  in  October),  10  would  be  entered  here. 

If  1  is  entered  to  use  drainage  area  ratio  only: 


ENTER  DRAINAGE  AREA  FOR  UNCAGED  SITEJ 
ENTER  drainage  AREA  FOR  GAGED  SITE; 


DATE  -  90/07/18.  H  04250750  348480760430003636045SW04140102  128.00  523.71 

TIME  -  15.36.06.  N  04250750  SANDY  CREEK  NEAR  ADAMS,  N.  Y. 

CALCULATED  FLOWS  FOR  UNGAGED  SITE  -  DRAINAGE  AREA  =  191.0 

BASIN  PRECIPITATION  =  52.00 


PROGRAM  -  TRANMR 
PAGE  -  2 


TRANSFERRED  STREAMFLOW  DATA  FROM  SANDY  CREEK  NEAR  ADAMS,  NY  TO 
THE  SALMON  RIVER  AT  THE  SALMON  RIVER  RESERVOIR  (TRANMR -OPT I ON2) 


YEAR 

OCT 

NOV 

DEC 

JAN 

FEB 

MAR 

APR 

MAY 

JUNE 

JULY 

AUG 

SEPT 

1958 

79 .17 

580.21 

1152.89 

348.92 

217.26 

727.95 

871.57 

350.61 

221.47 

197 .55 

290.05 

711.86 

1959 

497.67 

436.41 

273.63 

797 .72 

515.59 

1098.57 

2044.60 

349.42 

115.61 

112.53 

89.68 

23.20 

1960 

204.50 

724.59 

910.35 

341.35 

853 . 47 

669 . 13 

1951.48 

326.46 

380.27 

57 .07 

19.42 

7 .68 

1961 

44.62 

185.51 

160.44 

148.92 

955.10 

1322.22 

1378.45 

296.35 

260.97 

94.43 

20.23 

22 . 17 

1962 

61.51 

265.89 

535.90 

681.51 

283.43 

1235.31 

1353,88 

285.22 

42.48 

44.73 

119.15 

81.01 

1963 

204 .19 

283.28 

211.56 

182.60 

209.29 

1578.10 

2302.59 

644.96 

95.77 

20.21 

51.58 

11 . 13 

Fig.  4.5.  Partial  ZOUT  file  when  option  2  was  selected  in  the  TRANMR  program  to  transfer  data  from  Sandy  Creek  near  Adams, 
NY  to  the  Salmon  River  at  the  Salmon  River  Reservoir. 
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If  2  is  entered  to  use  drainage  area  and  precipitation 
ratio: 

ENTER  DRAINACIE  AREA  ROR  TRIGAGED  SITRf 
ENTER  PRECIPITATION  FOR  DNGAGBD  SITE! 

ENTER  DRAINAGE  AREA  fOB  GAGED  StTE ! 

ENTER  PRECIPITATION  FOR  GAGED  SITE; _ 


If  3  is  entered  to  use  the  regional  statistics  method: 


ENTER  12  ESTIMATED  MONTHtY  MEAN  EtONS  EOR  TAIGAOED  SITE; 

ENTER-  U  ESTIMATED  MONTHLY  STANDARD  DEVIATION  OR  FLOWS  AT 
DNGAGED  SITE! _ 

The  regional  statistics  method  requires  a  study  using  ex¬ 
isting  data  to  determine  a  relation  between  the  mean  monthly 
flow  and  watershed  characteristics  and  betwem  the  monthly 
standard  deviation  of  flows  and  watershed  characteristics.  It 
is  outside  the  scope  of  this  manual  to  explain  how  to  develop 
the  equations;  however,  they  are  sometimes  published  in 
U.S.  Geological  Survey  reports. 
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Chapter  5. 

Water  Resource  Systems  Analysis 


Introduction 

The  objective  of  many  instream  flow  studies  is  to  com¬ 
pare  various  water  management  schemes.  These  schemes 
may  include  both  structural  and  nonstructural  consid¬ 
erations.  Structural  considerations  include  the  size  and 
locations  of  reservoirs  and  diversions.  Nonstructural  con¬ 
siderations  comprise  the  rules  for  the  operation  of  the 
reservoir  or  the  diversion.  Usually  the  analysis  of  the  water 
resource  system  will  be  done  by  the  sponsoring  agency  or 
group  and  the  streamflows  for  die  various  schemes  will  be 
made  available  by  the  sponsor.  The  instream  flow  analyst 
will  (or  at  least  should)  be  involved  in  the  selection  of  some 
of  the  alternatives.  The  instream  flow  work  then  proceeds 
through  the  various  time  series  analyses  using  the  spon¬ 
sor’s  streamflow,  or  management,  alternatives,  and  there 
is  no  need  for  the  instream  flow  analyst  to  do  any  water 
resource  systems  analysis. 

Occasionally,  the  need  for  the  instream  flow  analyst  to 
do  an  analysis  of  the  water  resource  system  does  arise. 
Usually,  this  is  due  to  the  sponsor  refusing  to  study  viable 
alternatives  or  having  limited  ability  to  do  a  water  resource 
systems  analysis.  The  programs  in  this  chapter  are  rela¬ 
tively  simple  water  resource  systems  models  that  can  be 
used  for  the  analysis  in  many  water  resource  systems  with 
which  the  instream  flow  analyst  comes  into  contact,  be¬ 
cause  most  systems  are  relatively  simple.  For  more  com¬ 
plex  systems,  the  analyst  should  consider  using  the  pro¬ 
grams  available  from  the  U.S.  Bureau  of  Reclamation  and 
the  U.S.  Army  Corps  of  Engineers,  as  well  as  programs 
available  from  other  groups. 

There  are  three  major  programs  in  this  chapter  that  actu¬ 
ally  do  the  water  resource  systems  analysis:  QABSDY, 
QABSMN,  and  RES  YLD.  The  other  programs  either  assist 
in  building  input  files,  analyzing  the  results  of  the  systems 
analysis,  or  reformatting  the  results  of  the  water  resource 
systems  analysis  so  that  they  may  be  used  as  input  to  the 
other  TSLIB  programs. 

The  QABSDY  and  QABSMN  programs  are  available  to 
analyze  the  situation  shown  in  Fig.  5.1.  The  idea  is  that  the 
flow  at  a  downstream  control  point  (Qo)  is  related  to  the  flow 
at  an  upstream  control  point  (Qi)  by  the  equation 

Qo  =  Qi“D, 

where  D  is  an  abstraction  (diversion)  from  the  river.  The 
QABSDY  program  uses  average  daily  flows  and  the 


QABSMN  uses  average  monthly  flows.  An  example  of  the 
use  of  the  QABSDY  program  would  be  the  analysis  of  the 
effect  of  a  small  hydroelectric  project  on  instream  flow 
values.  It  is  assumed  that  the  project  does  not  cause  rapid 
changes  in  streamflow  by  operating  in  peaking  mode.  A 
peaking  mode  project  would  have  to  be  analyzed  using 
techniques  not  presented  in  this  manual. 

Typically,  a  small  hydroelectric  project  diverts  flow 
from  a  river,  generates  energy,  and  then  returns  the  water 
to  the  river  downstream.  Often  the  distance  between  the 
diversion  point  and  the  return  flow  point  is  relatively  short 
with  negligible  travel  time  and  inflow.  In  such  cases,  the 
situation  is  as  shown  in  Fig.  5.1  and  the  management 
model  is 

D-0  if  (^ < QMIN  +  QTMIN 
D^Ql-QmN  if  QT>Qi>QMIN  +  QTMIN 

D  =  QT  if  Qi>QMIN  +  QT, 

where 

Qi  =  the  streamflow  without  a  diversion, 

D  *  the  diversion, 

QT  =  the  desired  flow  through  the  turbine  (or 
target  flow), 

QTMIN  *  the  minimum  flow  that  can  be  used  by 
the  turbine,  and 

QMIN  =  the  minimum  flow  allowable  in  the  river 
at  any  time  a  diversion  occurs. 

The  power  developed  by  a  given  project  is  calculated  by 
the  equation: 

P  -  e  (D)  H 

where 

P=  the  power, 

H  =  the  head  on  the  turbine, 

Yw  ’==  the  unit  weight  of  water, 

D  -  the  diversion  (hence,  flow  through  the 
turbine),  and 

e  =  the  efficiency  of  the  system. 
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(D) 


Fig.  5.1.  A  simple  diversion  from  a  stream. 


Qq  =  Qi:*  D 
•  Control  point 


For  any  system,  the  efficiency  is  a  function  of  flow 
through  the  turbine  and  is  highest  at  the  design  flow  for 
the  turbine.  Also,  any  turbine  system  will  have  a  mini¬ 
mum  flow  through  the  turbine  below  which  damage  can 
occur  to  the  turbine. 

Daily  values  of  streamflow  are  used  to  operate  the 
system  using  the  QABSDY  program.  After  the  analysis 
using  the  QABSDY  program,  then  the  HABTD  program 
(Chapter  6)  could  be  run  to  obtain  the  daily  values  of 
habitats.  The  HABTD  program  also  transforms  the  daily 
habitats  to  monthly  habitats.  The  analysis  of  the  monthly 
habitats  then  proceeds  in  the  usual  manner  (Chapter  8). 
When  doing  the  water  resource  systems  analysis  using 
the  QABSDY  program,  keep  in  mind  how  you  intend  to 
transform  the  daily  habitats  to  monthly  habitats  using 
one  of  the  methods  in  HABTD: 

•  the  average  daily  habitat  for  a  specified  month, 

•  the  minimum  daily  habitat  during  a  specified  month, 

•  the  minimum  daily  habitat  for  a  specified  number  of 
consecutive  days  during  the  month,  and 

•  the  median  habitat  value  for  the  month. 

The  use  of  a  minimum  7^-days  assumes  that  fish  can  be 
crowded  for  short  periods  and  cannot  fill  all  the  habitat 
during  relatively  short  periods  of  excess  habitat. 

The  assumption  is  made  in  the  analysis  that  the  mini¬ 
mum  flows  for  the  project  can  be  specified  for  each 
month  as  the  minimum  flow  during  the  specified  month. 
The  instream  flow  requirement  can  be  specified  for  any 
period  desired  (i.e.,  weekly,  monthly,  a  rule  curve,  etc.). 
Data  for  the  North  Fork  of  the  Snoqualmie  River  near 
Snoqualmie  Falls,  Washington,  are  used  for  illustration. 
The  physical  habitat-versus-streamflow  relation  was 
shown  in  Chapter  1  of  this  manual.  Only  the  time  series 
for  the  adult  rainbow  trout  is  presented  here. 

For  this  illustration,  a  flow  of  100  cfs  was  used  as  the 
minimum  value  (QMIN)  of  the  instream  flow  when  a 
diversion  occurs.  The  minimum  diversion  (QTMIN)  was 
assumed  to  be  10  cfs,  and  the  desired  diversion  (QT)  was 
assumed  to  be  75  cfs.  (Normally,  a  variable  instream 
flow  requirement  would  be  specified.) 


The  period  of  records  used  was  for  41  water  years 
(1930-49  and  1962-82).  The  steps  followed  were 


1.  Generate  a  daily  time  series  of  diversions  and  in- 
stream  flow  using  the  operation  logic  and  values 
specified  here. 

2.  Develop  a  time  series  of  daily  habitat  values  using  the 
streamflow  for  the  cases  of  with  and  without  the 
diversion.  The  daily  habitat  time  series  was  then 
converted  to  a  monthly  habitat  index  using  the  mini¬ 
mum  of  any  10  consecutive  days  during  the  month. 
The  equation  is 


HA(y)  = 


10 


mm 


r  10 

5^  HAD  (7,0 
1=1 


where 


HAD  =  a  daily  habitat,  and 
HA  the  habitat  index  for  the  month  / 


Anyone  doing  a  habitat  analysis  could  select  other 
indices  as  well  as  other  time  periods  for  the  index. 

A  comparison  of  the  preproject  and  postproject  dura¬ 
tion  curves  for  the  streamflow  with  all  months  is  given 
in  Fig.  5.2.  Figure  5.3  is  a  comparison  of  the  preproject 
and  postproject  physical  habitat  for  adult  rainbow  trout. 
Figure  5.4  is  a  plot  of  the  diversion.  Selected  data  from 
the  duration  curves  is  given  in  Table  5.1. 

How  one  uses  the  information  in  Figs.  5.2  through  5.4, 
Table  5.1,  and  the  techniques  chosen  to  produce  the 
figures  and  table  themselves  depends  on  the  objective 
selected  for  the  analysis.  However,  this  is  outside  the 
scope  of  this  manual. 

The  use  of  the  monthly  diversion  program  (Q  ABSMN) 
is  similar  to  the  daily  diversion  program  (QABSDY) 
described  previously. 

The  third  water  resource  systems  analysis  program  is  the 
RESYLD  program.  This  program  is  a  simple  reservoir 
operations  program;  the  system  analyzed  is  shown  in  Fig. 
5.5,  The  program  operates  the  system  by  attempting  to 
meet  the  following  demands: 


Percent  of  months  exceeded 
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Fig.  5.2.  Comparison  of  pre-  and  postproject 
monthly  instream  flows  for  a  project  on  the 
North  Fork  Snoqualmie  River  with  target 
diversion  of  75  cfs,  minimum  diversion  of 
10  cfs,  and  minimum  flow  requirement  of 
100  cfs. 


Fig.  53.  Comparison  of  pre-  and  postproject 
monthly  physical  habitat  for  adult  rainbow 
trout  for  a  project  on  the  North  Fork  Sno¬ 
qualmie  River  with  target  diversion  of 
75  cfs,  minimum  diversion  of  10  cfs,  and 
minimum  instream  flow  requirement  of 
100  cfs. 


Habitat  (ft2/1,000  ft)x10 
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Fig.  5.4.  Monthly  diversion  for  a  project  on 
the  North  Fork  Snoquahnie  River  with  tar¬ 
get  diversion  of  75  cfs,  minimum  diversion 
of  10  cfs,  and  minimum  instream  flow  re¬ 
quirement  of  100  cfs. 


1.  A  diversion  from  the  reservoir  (P), 

2.  A  flow  used  to  generate  hydropower  (Qp), 

3.  An  instream  flow  need  in  the  river  just  downstream 
of  the  reservoir  (I), 

4.  A  water  right  diversion  at  some  downstream  control 
point  (D),  and 

5.  An  instream  flow  need  at  the  downstream  control 
point  (F). 

The  three  factors  not  under  control  of  the  system  op¬ 
eration  are  the  inflow  to  the  reservoir  (Qi),  the  local 
inflow  downstream  from  the  reservoir  (Ql),  and  the  net 
evaporation  rate  from  the  reservoir  surface  (E).  The 


actual  flow  from  the  reservoir  (Qo)>  the  actual  down¬ 
stream  flow  (QoO,  the  actual  diversion  (P),  the  actual 
diversion  for  water  rights  downstream  (D),  and  the  actual 
evaporation  (E)  depend  on  the  criteria  used  to  operate  the 
reservoir  and  the  demands.  The  actual  evaporation  (E)  is 
the  evaporation  rate  (e)  times  the  surface  area  of  the 
reservoir;  the  surface  area  depends  on  the  reservoir  con¬ 
tents.  The  equation  for  the  outflow  (Qo)  is 

Qo  =  Qi-AS  +  P  +  E 
and  for  the  downstream  control  point  is 

Qo'  =  Qo  +  Ql“DQl. 


Table  5.1.  Selected  duration  data  for  streamflows,  diversions,  and  adult  rainbow  trout  for  the  assumed  project  on  the 

North  Fork  Snoqualmie  River,  Washington, 


Statistic 

Streamflow  (cfs) 

Habitat  (ftVl, 000  ft) 

Average 

diversion 

(cfs) 

Without 

project 

With 

project 

Without 

project 

With 

project 

With 

project 

10%  Exceedence 

893 

818 

20,600 

20,100 

75.0 

Average 

440 

16,500 

14,900 

62.3 

Median 

474 

402 

18,200 

16,100 

75.0 

90%  Exceedence 

137 

107 

8,500 

8,500 

22.3 
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Fig-  5.5  A  simple  reservoir  system. 


S  =  Change  in  storage 
Ql  =  Inflow  to  reservoir 
Qq,  Qq'  =  Downstream  flow 

p  =  Diversion  from  reservoir 
E  =  Net  evaporation 
D  =  Downstream  diversion 
Qp  =  Power  generation  flow 
Ql  =  Local  inflow 


The  term  AS  is  the  change  in  storage  if  the  reservoir  and 
the  terms  Ql  are  losses  from  the  channel  between  the 
control  point  at  the  reservoir  and  the  control  point  down¬ 
stream. 

The  operation  criteria  for  the  reservoir  are  part  of  the 
logic  of  the  program.  There  are  many  options  in  the 
program. 

The  reservoir  is  considered  to  be  divided  into  a  number 
of  zones  as  shown  in  Fig.  5.6.  The  maximum  storage 
caimot  be  exceeded  without  risk  of  structural  failure,  and 
the  reservoir  cannot  be  drawn  down  below  the  bottom  of 
the  usable  storage  (the  absolute  minimum)  by  release  to 
the  power  house  or  to  any  diversion.  The  actual  storage 
may  be  reduced  below  the  absolute  minimum  by  evapo¬ 
ration. 

The  buffer  storage  is  a  storage  level  that  activates  a 
reduction  in  releases  below  the  desired  level.  The  pro¬ 
gram  has  a  number  of  options  on  how  the  reduction 
occurs;  this  is  explained  in  the  RESYLD  program  sec¬ 
tion.  The  simplest  of  this  is 


where 


QA  =  Qr 


S-Sa^ 
Sb“  Sa 

V 


Qt  =  the  target  release  to  a  specific  use, 


Qa  =  the  actual  release. 


S  =  the  water  storage  in  the  reservoir, 

Sa  =  the  absolute  minimum  storage,  and 
Sb  =  the  buffer  storage. 

The  reduction  ranges  from  zero  percent  when  the  reser¬ 
voir  contents  are  larger  than  Sb  to  100%  when  the  storage 
is  down  to  the  absolute  minimum. 

The  RESYLD  program  is  a  derivative  of  the  Reservoir 
Yield  Program  of  the  Hydrologic  Engineering  Center  of 
the  U.S.  Army  Corps  of  Engineers  (HEC  1966).  The 
program  has  been  modified  to  allow  the  analysis  to  inves¬ 
tigate  instream  flow  management  alternatives. 


y  Maximum  storage  (S|^) 


Fig.  5.6.  Conceptual  division  of  a  reservoir 
into  zones  as  used  in  the  RESYLD  pro¬ 
gram. 
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Water  Resource  Systems  Analysis  Programs 

Program  BatcIVProceduie 

Name  Fil^ian^  RmcticMi  _ Program  Descriptim _ 

QABSDY  RQABSDY  Water  resource  Subtracts  a  diversion  flow  by  day  from  a  daily  stieamflow  file  while 

systems  leaving  a  user-specified  minimum  flow  in  the  main  stream, 

analysis 

RQABSDY,  ZDQ,  ZDQD,  ZDQR,  ZDQN,  ZOUT 

ZDQ  *  Daily  streamflow  file  in  WATSTORE  format,  or  a  free- 
formatted  file  with  streamflows  and  dates  (input). 

ZDQD  «  Diversion  streamflows  in  daily  flow  file  format,  or  a  free- 
formatted  file  with  diversion  flows  and  dates  (input). 

ZDQR  =  Required  minimum  instream  streamflows  in  daily  flow  file 
format,  or  a  free-formatted  file  with  required  instream 
flows  and  dates  (input). 

ZDQN  =  Daily  streamflow  file  with  flows  left  after  the  diversion 
(output). 

ZOUT  =  QABSDY  results,  including  annual  shortages  and  diver¬ 
sions  (output). 

QABSMN  RQABSMN  Water  resource  Subtracts  a  diversion  flow  by  month  from  a  monthly  streamflow  file 

systems  while  leaving  a  user-specified  minimum  flow  in  the  main  stream, 

analysis 

RQABSMN,  ZMONQ,  ZMONQN,  ZOUT 

ZMONQ  =  Monthly  streamflow  file  in  USGS  or  NWDC  format 
(input). 

ZMONQN  =  Monthly  streamflow  file  in  the  same  format  as  the 
ZMONQ  input  file,  with  diversion  flows  subtracted 
from  the  monthly  flows  (output). 

ZOUT  =  QABSMN  results,  including  annual  shortages  and  diver¬ 
sions  (output). 


Water  Resource  Systems  Analysis  Programs 
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Program  Batch/Proceduie 
Name  Filename 


RESYLD  RRESYLD 


RESIN  RRESIN 


CHGMIN  RCHGMIN 


Rmction  _ Program  Descriptioa _ 

Water  resource  Operates  a  single  reservoir  with  monthly  flows  using  criteria  such  as 

^sterns  the  maximum  and  minimum  flow  at  the  reservoir  and  downstream, 

analysis  downstream  water  rights,  pipe  flow  from  the  reservoir,  and  power  pro¬ 

duction. 

RRESYLD,  ZRESIN,  ZRES,  ZOUT 

ZRESIN  “  RESYLD  input  file  created  by  the  RESIN  program  (in¬ 
put). 


ZRES  =  RESYLD  output  file  containing  pipe  and  river  flows  from 
the  reservoir,  river  flow  downstream,  reservoir  storage,  in¬ 
flow,  elevation,  evaporation,  surface  area,  unregulated  flow 
downstream,  downstream  water  rights,  and  power  produc¬ 
tion  (output). 

ZOUT  =  RESYLD  results  (output). 

RESYLD  input  Creates  an  input  file  for  the  RESYLD  program  with  the  flows  from 
file  creation  one  or  two  monthly  streamflow  files  or  from  user  input. 

RRESIN,  ZRESIN,  ZMONQ,  ZMONQ2 

ZRESIN  *  RESYLD  input  file  (output). 

ZMONQ  =  Monthly  streamflow  file  in  USGS  or  NWDC  format. 

Reservoir  inflows  will  be  calculated  from  this  flow  file. 
The  local  inflows  can  also  be  calculated  from  this  file  or 
entered  manually  (optional  input). 


ZMONQ2  =  Monthly  streamflow  file  in  USGS  or  NWDC  format. 

Local  inflows  will  be  calculated  from  this  flow  file  if 
two  flow  files  are  used  as  input  (optional  input). 


ZRESIN  file  Changes  the  minimum  flow  values  for  the  river  at  the  dam,  the  pipe  at 

modification  the  dam,  and  the  river  at  the  downstream  control  point. 

RCHGMIN,  ZRESIN,  ZRESINN 

ZRESIN  =  RESYLD  input  file  (input). 

ZRESINN  =  New  RESYLD  input  file  with  modified  minimum  flow 
values  (output). 
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Program  Bald^Ptocedure 
Name  Filename 

RESYI  RRESYI 


RSTOMQ  RRSTOMQ 


Rmction 
Reservoir 
yield  index 
computation 


_ Program  Description _ 

Computes  the  yield  index  for  a  reservoir  given  a  RESYLD  input  file 
and  a  monthly  time  series  file  with  reservoir  surface  area  cm-  storage 
volume  values. 


RRESYI,  ZRESIN,  ZMTS,  ZMTSN,  ZANTS,  ZOUT 


ZRESIN  =  RESYLD  input  file  (input). 

ZMTS  =  Mcmthly  time  series  file  containing  reservoir  surface  areas 
or  storage  volumes  (input). 

ZMTSN  ==  Monthly  time  series  file  containing  reservoir  yield  index 
values  (output). 


ZANTS  ^  Annual  time  series  file  containing  reservoir  yield  index 
values  (output). 

ZOUT  =  RESYI  results  including  area,  storage  volume,  and  yield 
index  (output). 

RESYLD  cxitput  Converts  the  output  file  (ZRES)  from  the  RESYLD  program  to  a  mul- 
file  cmverricm  tirecord  monthly  flow  file. 


RRSTOMQ,  ZRES,  ZMONQ 


ZRES  =  RESYLD  output  file  (input). 

ZMONQ  ^  Monthly  flow  file  in  USGS  or  NWDC  format  (output). 


CHGMIN  Program 
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CHGMIN  Program 


Introduction 

The  CHGMIN  program  changes  the  following  mini¬ 
mum  flow  values  in  the  RES  YLD  input  file  (ZRESIN):  the 
outflow  to  the  river  at  the  dam,  the  pipe  (diversion)  flow 
at  the  dam,  and  the  flow  in  the  river  at  the  downstream 
control  point.  If  the  RESYLD  input  file  does  not  contain 
minimum  flow  values  for  these  three  items,  then  they  will 
not  be  changed. 

Running  CHGMIN 

RCHGMEV,  ZRESIN,  ZRESINN 

ZRESIN  =  RESYLD  input  file  (input). 

ZRESINN  *  New  RESYLD  input  file  with  modified 
minimum  flow  values  (output). 

DATA  TITLE  IS- _ 

The  three  title  lines  and  the  first  period  from  the  input 
ZRESIN  file  will  be  displayed. 

MINIMUM  OOTPLOW  TO  JUVER  IN  CfS  IS  - 
PERIOD  Plow 


The  periods  and  the  previously  entered  flows  will  be 
displayed. 

Example: 

Minimum  outflow  to  river  in  cfs  is — 

Period  Row 

10  20.00 

11  20.00 

12  20.00 

1  30.00 

2  30.00 

3  40.00 

4  50.00 

[more  data  here] 


;  CHANGE  :  MlNi:MUMS,  X  FOR  NO  CHANQg; 


If  0  is  entered  to  change  minimums: 

■ENTER  NEW  MINIMUM8  (12) : _ 


Enter  the  12  new  values  separated  by  a  space,  comma, 
or  carriage  return. 

You  will  be  prompted  to  change  the  minimum  pipe  flow 
data  and  the  minimum  flow  at  downstream  control  point 
data  in  the  same  way. 
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RESIN  Program 


Introduction 


If  1  is  entered,  the  local  inflows  will  be  calculated  from 
the  second  streamflow  file  (ZMONQ2)  specified  as  input. 


The  RESIN  program  creates  an  input  file  for  the 
RESYLD  program.  Before  using  the  RESIN  program, 
review  the  RESYLD  program  documentation  for  an  expla¬ 
nation  of  the  options  and  variables. 

The  ZRESIN.DAT  file  on  your  sample  disk  is  a  sample 
input  file  to  the  RESYLD  program  that  was  created  by  the 
RESIN  program. 

Running  RESIN 

RRESIN,  ZRESIN,  ZMONQ,  ZMONQ2 
ZRESIN  *  RESYLD  input  file  (output). 

ZMONQ  “  Monthly  streamflow  file  in  USGS  or 
NWDC  format  (optional  input).  (Reser¬ 
voir  inflows  will  be  calculated  from  this 
flow  file;  local  inflows  can  also  be  cal¬ 
culated  from  this  file  or  entered  manu¬ 
ally.) 

ZMONQ2  “  Monthly  streamflow  file  in  USGS  or 
NWDC  format  (optional  input).  (Local 
inflows  will  be  calculated  from  this  flow 
file  if  two  flow  files  are  used  as  input.) 

EtTTER  1  FOR  FULL  RESVLD  INPUT  PILE 

"  0  FOR  RESERVOIR  AND  1X)CAL  INFLOWS  ONLY  : 


The  reservoir  and  local  inflow  data  (lines  beginning  with 
QR  and  QL)  are  at  the  bottom  of  the  ZRESIN  file.  Option 
0  creates  a  file  with  just  these  lines.  This  allows  the 
analysis  of  the  same  RESYLD  data  using  different  reser¬ 
voir  and  local  inflows.  The  original  RESYLD  input  file 
would  be  edited  and  the  QR  and  QL  lines  replaced  with 
the  new  QR  and  QL  lines. 


1SNTER  THREE  TITLE  LINES  FOR  THE  RESVLt)  INFtyt  FILE? 


Enter  three  lines  of  information  (up  to  80  characters  per 
line)  to  identify  the  information. 

RESYLD  IOC  OPTIONS:  (See  Table  5.1). 


rOCd)  -IF  RESERVOIR  RELEASE  IS  LESS  THAN  DOWNSTREAM  DEMAND! 
0  »  TO  SET  FLOW  EQUAL  TO  0.0 
1  -  TO  SET  PLOW  TO  RESERVOIR  INFLOW 

ENTER  XOCiUi 

IOC (2)  -TREATMENT  OF  CONFLICTS  BETWEEN  PIPE  AND  RIVER 
0  “  PIPE  HAS  PRIORITV  OVER  RIVER 

1  »  PIPE  AND  RIVER  HAVE  EQOAL  PRIORITV 

2  RIVER  HAS  PRIORITY  OVER  PIPE 

a  ^  USE  A  REDUCTION  LIMITED  BY  AN  ABSOLUTE 

MINIMUM  FOR  PIPE  AND/OR  RIVER  THAT  WILL  BE 
DELIVERED  If  AT  ALL  POSSIBLE,  EQUAL  PRIORITY 
OTHERWISE 

4  *  LIMIT  RELEASE  TO  RIVER  IF  STORAGE  IS  LESS  THAN 
A  GIVEN  MINIMUM.  PIPE  HAS  PRIORITY 
$  RIVER  AND  PIPE  HAVE  ABSOLUTE  LIMIT  OF  PLOWS 
and  flow  for  RIVER.  OTHERWISE  EQUAL  PRIORITY 

ENTER  10C(2}t 

ij  lOCd)  -  USE  OF  STORAGE  ANALYSIS 

0  «  USE  BUFFER  STORAGE  ANALYSIS  TO  REDUCE  RELEASE 
1  *  DO  NOT  USB  BUFFER  STORAGE  ANALYSIS 

ENTER  IOC(3) : 

:  10C(4>  -TREATMENT  OF  SHORTAGE  IN  DOWNSTREAM  BUFFER  ZONE 

0  »  USE  FLOW  MINUS  EVAPORATION  PLUS  WATER  FRtM  BUFFER 
ZGUtt 

X  ♦  USE  FLOW  PLUS  WATER  FROM  BUFFER  ZONE 

ENTER  IOC (4) : 

IOC (5)  -SELECTION  OF  INITIAL  RESERVOIR  CONTENTS 
FOR  MORE  THAN  ONE  GROUP  OF  YEARS 
0  »  USE  value  given  for  first  GROUP  OF  YEARS 
1  »  USE  RESERVOIR  CONTENTS  FROM  END  OF  PREVIOUS  GROUP 
OF  YEARS 


ENTER  IOC<5) t 


ENTER  ID "NUMBER  TOR  PROTECT'  (l6  CHAR  HaX) j 


This  ID  number  is  used  as  a  reference  for  the  site,  run, 
or  whatever  the  user  chooses. 


ENTER  I  TO  READ  RESERVOIR  INFLOWS  FROM  MONTHLY  FLOW  FILE 
q  TO  ENTER  RESERVOIR  INFLOWS  FROM  KEYBOARD; _ 


IfIOC(2)is3or4: 


If  1  is  entered,  the  reservoir  inflows  will  be  calculated 
from  the  first  streamflow  file  (ZMONQ)  specified  as  input. 


ENTER  ABSOLUTE  MINIMUM  RIVER  RELEASE: 

ENTER  MINlMlR^  STORAGE  FOR  RIVER  RELEASE: 
ENTER  ABSOLUTE  MINIMUM  DIVERSION  RELEASE i 
ENTER  MINIMUM  STORAGE  FOR  DIVERSION  RELEASE; 


ENTER  1  FOR  LOCAL  INFLOW  FROM  A  SEPARATE  FILE  • 

_ 0  OTHERWISE _  _ i  If  IOC(2)  is  5: 


If  0  is  entered,  local  inflows  will  either  be  calculated 
from  the  first  streamflow  file  (ZMONQ)  specified  as  input 
or  entered  manually. 


ENTER  ABSOLUTE  MINIMUM  RIVER  RELEASE: 

enter  minimum  STORAGE  FOR  RIVER  AND  DIVERSION  RELEASE; 

ENTER  absolute  MINIMUM  DlVERSI<»I  RELEASE: 

ENTER  THE  NUMBER  OF  TIME  PERIODS  THE  MINIMUM  FLOW 
MAY  BE  RELEASEDt 

ENTER  FLOW  IF  MINIMUM  RIVER  RELEASE  HAS  BEEN  USED 
FOR  TOO  MANY  TIME  PERIODS; 

ENTER  THE  NUMBER  OF  YEARS  AND  THE  STARTING  YEAR: _ 
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Enter  the  number  of  years  to  be  analyzed  and  the  first 
year  to  analyze. 

BHTER  0  TO  USE  MONTHS  FOR  TIME  PERIODS,  OR  ENTER  THE  NUMBER  :::::::: 
OF  TIME  PERIODS  FOR  EACH  (MAXIMUM  IS)  { _ 


The  year  can  be  divided  into  up  to  15  periods  of  equal 
or  unequal  length;  the  usual  application  is  in  months. 

i'ENTER  THE  STARTING.  TIME  PERI^  !  ( 1 0 ; :  qi  1 /QCTOBgR ,  ETC.);  _ 


For  example,  if  the  first  month  on  the  input  monthly 
streamflow  file(s)  is  October  (streamflow  files  are  usually 
in  water  years)  and  you  are  using  monthly  periods,  you 
would  enter  10  here.  Another  example,  if  you  were  using 
six  periods  of  2  months  each  and  your  flow  data  starts  with 
October,  then  you  would  enter  5  because  the  fifth  period 
starts  with  October. 

If  months  are  not  being  used  as  periods,  then  you  will 
be  prompted  to: 

Em*ER  THE  number  OF  DAYS  iN  EACH  TIME  PERIOD,  OR 
0  TO  ENTER  A  DIFFERENT  NUMBER  OF  DAYS  FOR  EACH 
TIME  PERIOD; 

READING  RESERVOIR  FLOW  VALUES 

reading  Local  flow  values _ 


This  message  will  only  be  displayed  if  reservoir  and 
local  inflow  values  are  being  read  from  monthly  stream- 
flow  files.  If  there  are  errors  in  the  file(s),  the  program  will 
print  out  a  message  to  identify  the  file  that  contains  the 
error. 


ENTER  THE  NUMBER  ^pFiPOINTS  iN::  the  RESERVOIR  STORAGE 
TABLE  (MAX  40)  ; _ 


This  is  the  storage-versus-area  and  storage-versus- 
elevation  table  for  the  reservoir. 

ENTER  f  — 3  RESERVOIR  STORAGE  LVALUES  IN  ACRE- FEET; _ 


The  blank  will  contain  the  number  of  points  entered  in 
the  previous  step.  Enter  the  reservoir  storage  values  (in 
acre-feet)  corresponding  to  the  surface  areas  and  eleva¬ 
tions  for  each  point.  These  values  must  increase  continu¬ 
ously. 

!■  ENTER  THE  RESERVOIR  SURFACE  AREAS  IN  ACRES  t _ 


Enter  the  reservoir  area  in  acres  for  each  storage  value 
entered  in  the  previous  step. 

ENTER  1  TO  USE  WATER  SURFACE  ELEVATIONS,  OR  0  IF  WATER 
li SURFACE  ELEVATIONS;  ARE  NOT:; :TO:  BE^^  U  •  (POWER  PRODUCTION  IS  . 

NOT  BEING  CONSIDEREPrr^^^  '  •-  _ 


If  1  is  entered: 

; blTER  S  — 1  RKSKRVOlP.  WATER  SURFACE  ELEVATIOHS  : (IH  FEET):  ;  :,/ 


Enter  the  reservoir  water  surface  elevations  (in  feet)  for 
each  storage  value  entered. 


RES  YLD  WILL  ALLOW  YOU  TO  RUN  THROUGH 
COMPUTATIONS  FOR  UP  TO  FOUR  DIFFERENT 
GROUPS  OF  YEARS  FROM  THE  FLOWS  ON  THE 
DATA  SET.  THE  GROUPS  OF  YEARS  MUST  BE 
CONSECUTIVE. 


i; ENTER ;  THE  NUMBER  OF  GROUPS  OF  YEARS; 


For  example,  if  3  is  entered,  you  will  be  prompted  to 

:  ENTER  NUMBER  OF  YEARS  AND  STARTING  YEAR  FOR  THE 
3  GROUPS  OF  YEARS: 


RESYLD  will  process  the  flow  data  for  each  group  of 
years  specified.  The  program  can  start  with  any  year  in  the 
data  set  and  use  any  number  of  years  less  than  or  equal  to 
the  remainder  in  the  data  set. 


ENTER  1  For  flow  REpUlREMENTS  IN  ACRE ♦FEET  PER  PERIOD 
_ 0  FOR  FLOW  REQUIREMENTS  IN  CUBIC  FEET  PER  SECOND 


All  flow  requirements  (i.e.,  minimum  diversion  flows, 
maximum  instream  flows,  etc.)  must  use  the  same  unit, 
either  acre-feet  per  period  or  cubic  feet  per  second. 

?::ENTER  the  number  of  computation  iterations  (USUALLY  2>  5 


Enter  the  number  of  complete  computations  desired  for 
each  period  for  successive  approximations  of  power, 
evaporation,  and  reservoir  quality.  Usually  is  entered. 

ENTER  1  TO  PRINT  YEARLY  CALCULATIONS 
_ _ 0  OTHERWISE ;  ^  ■ 


Option  0  lists  averages  and  other  statistics  for  the  entire 
run;  option  1  lists  statistics  by  year. 

: enter  THE  INITIAL  STORAGE  ;< IN  ACRE- FEET)  OF  THE  RESERVOIR; 


Enter  the  reservoir  storage  (in  acre-feet)  at  the  start  of 
the  analysis. 

QfTER  CONVERSION  FACTOR  FOR  RISERVOIR  INPWWS, 

ilP,  THE  RESERVOIR  AND  LOCAL  INFLOWS  ARE  IN  CPS, 
s ENTER  A  POSITIVE  CONVERSION  FACTOR  OR  0  FOR  NO  CONVERSICTI; 

IF  THE  RESERVOIR  AND  LOCAL  INFLOWS  ARE  IN  ACRE-FEET, 

ENTER  A  NEGATIVE  CONVERSION  FACTOR  OR  -I  FOR  NO  CONVERSION: 


FOR  THE  FOLLOWING  PROMPTS,  IF  -2  IS 
SELECTED,  YOU  WELL  BE  PROMPTED  IMMED¬ 
IATELY  FOR  THE  DATA  FOR  THE  FIRST  YEAR. 
YOU  WILL  BE  PROMPTED  LATER  TO  ENTER  THE 
VALUES  FOR  ADDITIONAL  YEARS. 
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irtifiiMUM 'liEOUiREiii :  J «STREiAM  f 1  Xf i - 

-1  TP  ENTER  WVER  ETPW  VALPBS  >011  EACH  TIME  PERIO0 
-2  TX>  Ettrm  RIVER  nXM  VAlimS  for  each  time  period  each  YEAR; 


This  option  allows  you  to  specify  a  minimum  instream 
flow  for  the  stream  below  the  dam  for  each  period  (usually 
a  month). 

If  -1  or  -2  is  entered: 


:;ENTER  THE  t  — 3  MINIMUM  PLOW  VALOESi 


The  blank  will  contain  the  number  of  periods  for  each 
year  specified  in  a  previous  prompt.  If  -2  was  selected, 
enter  the  minimum  flow  values  for  the  first  year.  You  will 
later  be  prompted  to  enter  the  values  for  additional  years. 


Note:  This  type  of  prompting  will  be  done  whenever 
-1  or  -2  are  selected  for  the  following  prompts. 


enter  minimum  REQUIRE&  DIVERSION  (PIPE)  PLOW  AT  DAM 

-X  TO  ENTER  MlNIMtM  DIVERSION  RIjOW  VALUES  FOR  EACH  TIME 
PERIOD 

'>2  TO  ENTER  DIVERSION  FLOW  VALUES  FOR  EACH  TIME  PERIOD, 
each  YEAR:  _ 


This  is  the  minimum  flow  to  divert  (abstract)  from  the 
dam  (that  flow  necessaiy  for  municipal,  irrigation,  or  other 
purposes). 


ENTER  CHANNEL  CAPACITY  AT  DAM 

-X  TO  ENTER  CHANNEL  CAPACITIES  FOR  EACH  TIME  PERIOD  .  . 

^-2  TO  ENTER  CHANNEL  CAPACITIES  FOR  EACH  TIME  PERIOD’  -EACH".  .. 
YEAR:  ‘  V-. 


This  is  the  maximum  permissible  flow  to  the  channel 
without  causing  flood  damages. 


ENTER  MINIMlW  i  REQUIRED  FLOW  AT  DOWNSTREAM  CC^TTROL  POINT 
”1  TO  ENTER  MINIMUM  FLOW  VALUES  FOR  EACH  TIME  PERIOD 
-2  TO  ENTER  FLOW  VALUES  FOR  EACH  TIME  PERIOD,  EACH  YEAR; 


This  is  the  minimum  permissible  flow  at  a  downstream 
point  considering  a  local  inflow  below  the  reservoir  and 
some  downstream  control  point  (local  flow  loss  will  be 
considered  later).  Water  rights  should  not  be  considered  in 
this  minimum  flow  value.  This  value  will  be  specified  later. 


ENTER  THE  MAXIMUM  PERMISSIBLE  PLOW  AT  DOWNSTREAM  CONTROL  POINT 
-1  TO  ENTER  MAXIMUM  FLOW  FOR  EACH  TIME  PERICH) 

-2  TO  ENTER  FLOW  VALDES  FOR  EACH  TIME  PERIOD,  EACH  ^AR;'  -=  ■  • 


This  is  the  maximum  permissible  flow  at  a  downstream 
point.  This  is  usually  the  channel  capacity  at  that  point. 


ENTER  MINIMUM  REQUIRED  FLOW  FOR  WATER  RIGHTS : DOWNSTREAM  OF  THE 
CCdJTROL 

TO  ENTER  WATER  RIGHT  FLOW  VALUES  FOR  EACH  TIME  PERIOD 
"2  TO  ENTER  WATER  RIGHT  FLOW  FOR  EACH  TIME  PERIOD,  EACH  YEAR: 


This  is  the  minimum  permissible  flow  downstream  from 
the  control  point  for  water  rights. 


If  1  is  entered: 


enter  effluent  (IN  7<m  PER  DAY)  EETWEEN  RESERVOIR 
AND  DOWNSTREAM  POINT  PC»l  ALL  TIME  PERIODS, 

-1  TO  ENTER  EFFLUENT  FOR  EACH  TIME  FEftlOD,  OR 

>-2  TO  ENTER  EFFLUENT  FOR  EACH  TIME  FERIOP,  EACH  YEAR: 


Enter  the  effluent  (in  tons  per  day)  between  the  reservoir 
and  some  downstream  control  point. 


ENTER  MAXIMUM  PERMISSIBLE  CCWCENTRATIOM  <IN  PPM  OR 
:;DEGREE$  OF  TEMPERAtUREJi ;  :0F :  WATB^ 

AT  DOWNSTREAM  POINT  FOR  ALL  TIME  PERIODS, 

‘•I  TO  ENTER  W.O,  VALUES  FOR  EACH  TIME  PERIOD,  OR 

TO  ENTER  w,0,  VALUES  FOR  EACH  TIME  PERIOD,  EACH  YEARt 

ENTER  INITIAL  WATER  QUALITY  QF  RESERVOIR: _ 


Enter  the  initial  water  quality  of  the  reservoir  (in  parts 
per  million  or  degrees  of  temperature). 


ENTER  THE  NUMBER  OF  WATER  QUALITY ‘VERSUS -RESERVOIR 
OiNFLOW  PAIRS  (MAX  10> :  . 


Reservoir  inflow  must  increase  continuously. 


ENTER  NUMBER  OF  WATER  QUALITY ‘ VERSUS ‘LoCaL  INFLOW 
PAIRS  (MAX  XO) t 


Local  inflow  must  increase  continuously. 


CENTER  MAXIMUM  RESERVOIR^  STORAGE  FOR  ALL  TIME  PERIODS#  " 

-1  TO  ENTER  MAXIMUM  STORAGE  VALUES  FOK  EACH  TIME  PERIOD,  OR 
-2  TO  ENTER  MAXIMUM  STORAGE  FOR  EACH  TIME  PERIOD,  EACH  YEAR: 


This  is  the  maximum  permissible  reservoir  storage  (in 
acre-feet)  for  the  whole  period  or  for  each  period. 


ENTER  MINIMUM  RESERVOIR  STORAGE  FOR  ALL  Tl^ffi  PERIODS 
"1  TO  ENTER  MINIMUM  STORAGE  FOR  EACH  TIME  PERIOD 
'2  TO  ENTER  MINIMUM  STORAGE  VALUES  FOR  EACH  TIME  PERIOD, 
EACH  YEAR: 


This  is  the  minimum  permissible  reservoir  storage. 


ENTER  MINIMUM  STORAGE  FROM  BUFFER  ZONE  FOR  ALL  ITMB  PERIODS, 

-1  TO  ENTER  MINIMUM  STORAGE  FOR  EACH  TIME  PERIOD,  OR 

-2  TO  Enter  MINIMUM  storage  FOR  EACH  TIME  PERIOD,  EACH  YEAR:  ■ 


Specify  a  storage  level  greater  than  or  equal  to  the 
minimum  permissible  reservoir  storage  at  which  shortage 
is  initiated. 


ENTER  I  IP  HYDROPOWER  IS  PART  OF  THE  ANALYSIS 
0  OTHERWISES  .. 


If  1  is  entered: 


ENTER  MINIMUM  POWER  PRODUCTION  FOR  ALL  TIME  PERIODS, 

-1  to  ENTER  MINIMUM  POWER  FOR  EACH  TIME  PERIOD,  OR 

-2  TO  ENTER  MINIMUM  POWER  FOR  BACH  TIME  PERIOD,  EACH  YEAR; 


Specify  a  minimum  power  requirement  per  period  (in 
thousands  of  kilowatts  per  hour). 


ENTER  1  IF  WATER  QUALITY  ANALYSIS  IS  TO  BE  DONE 
0  OTHERWISE;  .  •  -  _ _ 
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EINTER  J liStXlXRD. .  IfOWfiR  CAPACITY .  IN .  KILDVJATTS  PER  HOUR ; . 

.ENTER  THE  POWER  RIANT  EPEICIENCV,  D  TO  OSE  STANDARD 
VA1.UE  OF  ,  R6  y  -1  TO  ENTER  POWER  -  VERSUS  >EFFICIENC Y  TABIg  t 

If-1  is  selected,  plant  efficiency  values  are  expressed  as 
a  ratio  less  than  1  corresponding  to  reservoir  elevations. 

ENTER  THE  AVERACB  TAILWATER  ELEVATION  IN  PEBTs  ' 

1  ENTER  OUTLET  PLOW  CAPACITY  OR  -1  TO  OSE  A  PLOW 
CAPACITY -VERSOS -STORAGE  TABLE  1 _ ^ _ '  _ 

Enter  an  outlet  flow  capacity  in  cfs,  or  up  to  10  outlet 
capacities  (in  cfs)  versus  reservoir  storages  (in  acre- 
feet)  may  be  specified.  These  values  must  increase 
continuously. 

ENTER  AN  EVAPORATION  VALUE  FOR  ALL  TIME  PERIODS, 

-I  TO  ENTER  EVAPORATION  VALUES  FOR  EACH  TIME  PERIOD^  OR 
.-2  TO  ENTER  EVAPORATION  FOR  EACH  TINB  PERIOD,  EACH  YEAR? 


:06TA1N  RESERVOIR  AND  LOCAL  INFLOWS  OR  CC^JVeRT  fttoNTHLY 
PLOW  FILE  TO  RESERVOIR  AND  LOCAL  INFLOWS _ 

At  this  point  you  will  either  enter  the  reservoir  and  local 
inflows  manually,  or  they  will  be  calculated,  depending  on 
whether  monthly  streamflow  files  were  specified  as  input. 

If  one  monthly  flow  file  was  used  as  input,  the  reservoir 
inflows  will  be  calculated  from  this  flow  file.  The  local 
inflows  can  either  be  calculated  from  the  flow  file  or 
entered  manually.  If  two  streamflow  files  were  used  as 
input,  reservoir  inflows  will  be  calculated  from  the  first 
monthly  flow  file  and  local  inflow  will  be  calculated  from 
the  second  monthly  flow  file. 

If  ZMONQ  was  specified  as  input: 

ENTER  MULTIPLIER  TO  TRANSFORM  MCMTHLY  FLOWS  tO  RESERVOIR  INFLOWS  s 
ENTER  6  CHAR  STATION  NUMBER  FOR  RESERVOIR  INFLOWS  t 


Enter  a  reservoir  evaporation  (net  change  to  project 
conditions)  in  inches  per  year  or  specify  to  enter  a  reservoir 
evaporation  value  for  each  period. 

ENTER  FLCW  LOSS  BEPCSRE  DOWNSTREAM  CONTROL  POINT  FOR  ALL  ..TIME  PERIODS, 
-I  TO  ENTER  FLOW  LOSS  FOR  EACH  TIME  PERIOD,  OR 
-a  TO  ENTER  FLOW  LOSS  FOR  EACH  TIME  PERIOD,  EACH  YEAR; _ 

Enter  a  constant  channel  loss  below  the  reservoir  (in  cfs), 
or  specify  to  enter  a  constant  channel  loss  for  each  period. 

I'eNTER- VCONTROL  ;  ■  ; , : , '  : ./vi::;: 

Enter  a  chaimel  loss  below  the  reservoir  as  a  ratio  of  flow 
remaining  after  any  constant  loss  is  subtracted. 

^■JENTER  penstock  loss  COEPFlClEfh';|::vM^ 


This  number  is  on  QR  lines. 

If  0  was  entered  for  third  prompt  in  program: 

This  prompt  specified  that  local  inflows  would  either  be 
calculated  from  the  first  streamflow  file  (ZMONQ)  speci¬ 
fied  as  input  or  entered  manually. 

ENTER  0  FOR.  DIRECT  ENTRY  :.OF  LOCAL  INFLOWS 
_ 1  FOR  LOCAL  INFLOWS  AS  A  MULTIPLIER  *  MONTHLY  FLOWS t 

If  1  is  selected: 

ENTER  MULTIPLIER  FOR  LOCAL  INFLOWS J 

ENTER  6  CHAR  STATION  NUMBER  FOR  LOCAL  INFLOWS; 


This  prompt  will  only  appear  if  hydropower  is  being 
analyzed. 


ENTER  FULL  RESERVOIR  STORAGE 


This  is  the  full  pool  reservoir  capacity  (in  acre-feet). 


This  number  is  on  QL  lines. 


Note:  If  -2  (Enter  [ - ]  for  each  time  period,  each 

year)  was  entered  for  any  prompt  in  the  pro¬ 
gram,  you  will  now  be  prompted  to  enter  the 
values  for  each  time  period  for  each  year. 


iENTER'li'M^^lMU^  TOWER  •■'OENE^I  ON  >RaTEi 


This  prompt  will  appear  only  if  hydropower  is  being 
analyzed. 
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RESYI  Program 


Introduction 

The  RESYI  program  is  included  in  this  chapter  because 
one  of  the  important  fisheries  tradeoffs  in  systems  manage¬ 
ment  is  the  production  of  fish  in  the  reservoir  versus  the 
production  of  fidi  in  the  river.  The  RESYI  program  gives 
some  idea  of  the  variation  in  fishery  production  in  the 
reservoir  as  a  result  of  water  management  activities. 

The  RESYI  program  uses  a  productivity  index  based  on 
an  equatim  for  reservoir  presented  in  Youngs  and  Heimbuch 
(1982).  The  equation  is 

Yield  -  259.82  d-®-54  (TDS)®-34 

where 

A  is  the  surface  area  of  the  reservoir  (in  km^), 
d  is  the  mean  depth  (in  m),  and 
TDS  is  the  total  dissolved  solids  (in  mg/L). 

The  yield  is  in  kilograms.  The  mean  depth  is  calculated 
using  the  generic  equation 


where 

A  is  the  surface  area  of  the  reservoir,  and 
V  is  volume  in  km^  -m. 

Replacing  the  depth  with  this  equation  gives 

Yield  =  260  A^-^^ 

The  assumption  made  in  using  the  equation  to  compare 
water  management  alternatives  is  that  the  change  in  yield  is 
a  similar  function  of  the  same  terms.  An  additional  assump¬ 
tion  is  that  the  total  dissolved  solids  (TDS)  does  not  change 
because  of  a  change  in  water  management.  The  average  TDS 
used  to  develop  the  equation  was  121  mg/L,  which  is  used 
to  eliminate  the  TDS  term.  The  result  is 

Yield  =  1,328  A^*^^ 

The  program  actually  works  with  traditional  units  (volume 
in  acre-feet  and  surface  area  in  acres).  With  these  units  the 
equation  is 

Yield  =  9.14 

The  yield  is  still  in  kilograms.  The  yield  calculated  by  the 
RESYI  program  should  cmly  be  considered  as  an  index  to 
the  producticMi  from  the  reservoir.  It  is  the  variation  that  is 
important  in  an  instream  flow  study. 

The  equation  could  be  expressed  as 

Yield-xA^'V^ 

with  the  user  supplying  the  values  for  x,  y,  and  z.  This 
option  is  available  in  the  program. 


Running  RESYI 

RRESYI,  ZRESIN,  ZMTS,  ZMTSN,  ZANTS,  ZOOT 
ZRESIN*  RESYLD  input  file  (input). 

ZMTS  =  Monthly  time  series  file  containing  res¬ 
ervoir  surface  areas  or  storage  volumes 
(input). 

ZMTSN  =  Monthly  time  series  file  containing  res¬ 
ervoir  yield  index  values  (output). 

ZANTS=  Annual  time  series  file  containing  reser¬ 
voir  yield  index  values  (output). 

ZOUT=  RESYI  results  including  area,  storage 
volume,  and  yield  index  (output). 

Figure  5.7  contains  sample  output  from  the  RESYI 
program.  The  ZRESIN.DAT  and  SVR30.DAT  files  on 
your  sample  disk  were  used  as  input. 

BNTEK  two  tttJE  TITLE  FOR  ANNUAL  TIME  SERIES  FILE: 


This  output  file  (ZANTS)  is  an  aimual  time  series  file 
containing  reservoir  yield  index  values. 

ENTER  THE  INDEX  FOR  THE  FIRST  MONTH  ON  THE  MCaJTHLY 

TIME  SERIES  FILE  <iJAN.  ^  1,  FEB.  2,  ETC.): _ 


This  labels  the  months  in  the  input  monthly  time  series 
file  (ZMTS).  If  the  first  month  is  October,  you  would  enter 
10  here. 


THE  YIELD  INDEX  WILL  BE  CALCULATED  USING  THE  EOUATION: 

A  *  (AABA  **  B)  *  (STOSAOB  **  C) 

ENrro  A^  B,  AND  C  OR  THREE  0*S  TO  USE  DEFAULT  VALUES 

A  -  9.14  B  »  1,5<  C  »  -0.54 

ENTER  0  IF  MCmHLY  TIME  SERIES  FILE  CONTAINS  SURFACE 
AREA,  OR 

1  XF  MONTHLY  TIME  SERIES  FILE  CONTAINS  STORAGE 
VOLUME  ^ _ 


The  input  monthly  time  series  file  may  contain  surface 
areas  or  storage  volumes.  The  SVR30.DAT  file  used  to 
generate  the  output  in  Fig.  5.7  contained  storage  volumes. 

ENTER  1  TO  PLOT  MINIMUM  ANNUAL  YIELD  INDICES 
0  OTHERWISE. 


This  is  a  tabloid  plot  that  will  appear  on  the  screen  and 
be  written  to  the  ZOUT  file. 
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DATE  -90/07/24.  MELVERN  RESERVOIR  ROUTING  DATA  SET 

TIME  -  14.48.40.  DATA  FROM  CORPS  OF  ENGINEERS 


INPUT  FILE; 

MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 
MIN  RIVER  -  20,  PIPE  VARIABLE 

IOC  01010000000000000000  STATION  NUMBER;  QR911000 


YIELD  INDEX  BASED  ON  THE  EQUATION; 

9.14  *  (AREA  **  1.56)  *  (STORAGE  **  -0.54) 


SURFACE  AREA 

STORAGE  VOLUME 

YIELD  INDEX 

20.80 

58.40 

115.68 

52.00 

269  .70 

211.46 

71.10 

608.90 

221.93 

225.20 

1373.00 

864.19 

597.40 

3787 .00 

2288.97 

1035.00 

8688.00 

3445.37 

1511.00 

16300.00 

4426 .06 

1985.00 

26722.00 

5187 .32 

2704.00 

40551.00 

6707 .42 

3744.00 

59843.00 

9031.56 

4723.00 

85384.00 

10709 . 83 

5696.00 

116599.00 

12123.27 

6935.00 

154393.00 

14161.83 

8404.00 

200313.00 

16604.32 

10165.00 

255775.00 

19578.98 

11667 . 00 

299260.00 

22301.60 

14442.00 

349110.00 

28626 .28 

17436.00 

472668.00 

32609.38 

20806.00 

587216.00 

38209 .31 

22061.00 

630072.00 

40302.36 

The  computed  monthly  and  annual  yield  index  values  will  also  be  listed  in  the  file.  These  are  the  same  values 
that  are  written  to  the  ZMTSN  and  ZANTS  output  files  from  RESYI. 


PROGRAM  -  RESYI 
PAGE  -  1 


Fig.  5.7.  Sample  output  from  RESYI  program. 
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RESYLD  Program 


Introduction 

The  purpose  of  the  RESYLD  program  is  to  analyze  the 
yield  of  water  from  a  reservoir  (or  a  reach  of  stream).  The 
program  operates  a  single  reservoir  with  monthly  flows 
using  criteria  such  as  maximum  and  minimum  flows  at  the 
reservoir  and  downstream,  downstream  water  rights,  pipe 
flow  from  the  reservoir,  and  power  production. 

The  RESYLD  program  was  originally  the  REServoir 
YieLD  program  (computer  program  23-J2-L245)  devel¬ 
oped  by  L.  R.  Beard  of  the  Hydrologic  Engineering 
Center  of  the  U.S.  Army  Corps  of  Engineers  (650  Capitol 
Mall,  Sacramento,  California).  The  version  of  the  RE¬ 
SYLD  program  contained  in  the  TSLIB  programs  has 
been  modified  by  the  Aquatic  Systems  Modeling  Section 
at  the  National  Ecology  and  Research  Center  to  allow  the 
analysis  of  instream  flow  management  alternatives. 

The  RESYLD  program  performs  any  number  of  mul¬ 
tipurpose  routings  under  identical  conditions  for  a  single 
reservoir  with  optional  delivery  to  a  pipe  (diversion)  or 
river,  or  both,  and  with  maximum  and  minimum  flow 
controls  at  the  reservoir  and,  if  desired,  at  one  down¬ 
stream  control  point.  Power  generation  at  the  reservoir 
and  quality  control  at  the  downstream  control  point  are 
optional.  The  year  is  divided  into  any  number  of  periods 
(maximum  of  15)  of  equal  or  unequal  length.  Maximum 
and  minimum  permissible  storages  (and  all  other  quan¬ 
tities)  can  be  specified  as  uniform  or  varied,  with  similar 
or  dissimilar  patterns  each  year.  An  optional  minimum 
storage  above  the  absolute  minimum  can  be  specified  at 
which  shortages  in  withdrawals  from  storages  are  de¬ 
clared,  increasing  linearly  to  100%  at  the  absolute  mini¬ 
mum  storage. 

The  RESYLD  program  follows  closely  the  procedures 
commonly  used  in  hand  computation.  Where  a  direct 
solution  is  not  possible,  as  in  evaporation  and  power 
computation,  successive  approximations  are  made.  The 
first  approximation,  based  on  reservoir  stage  at  the  be¬ 
ginning  of  each  period,  is  used  to  establish  an  approxi¬ 
mate  average  stage  for  the  period;  the  next  approxima¬ 
tions  of  evaporation  and  power  are  based  on  this  average 
stage.  Outlet  capacity  is  approximated  once  only  on  the 
basis  of  reservoir  stage  at  the  start  of  each  period.  No 
delay  or  routing  of  outflows  to  the  downstream  control 
point  is  made.  Provision  is  made  for  an  optional  buffer 
zone  at  the  bottom  of  the  conservation  pool. 

The  reservoir  routing  is  made  by  first  searching  for  the 
largest  of  the  minimum  flow  requirements  for  all  pur¬ 
poses  and  the  smallest  of  the  maximum  permissible 


flows.  The  former  will  control  if  there  is  no  conflict;  the 
latter  will  control  if  there  is  conflict.  These  controls  are 
overridden  by  flows  necessary  to  empty  or  fill  the  con¬ 
servation  pool. 

Absolute  control  is  exercised  by  full  reservoir  and 
empty  reservoir  limitations.  If  storage  at  the  start  of  a 
period  is  within  the  bottom  buffer  zone  and  all  IOC 
options  are  zero,  then  the  release  from  the  reservoir  (over 
and  above  inflow  minus  evaporation)  is  reduced  by  the 
proportion  of  empty  space  in  the  buffer  zone.  Releases 
are  first  assigned  to  the  pipe  and  the  remainder  goes  to 
the  river.  These  controls  can  be  changed  by  the  use  of 
the  IOC  options  (Table  5.2)  added  by  the  Aquatic  Sys¬ 
tems  Modeling  Section. 

Power  is  generated  from  release  to  the  river  up  to  plant 
capacity.  Power  generation  and  release  required  for 
power  are  based  on  the  following  equation: 

P  =  0.08464eQH, 

where 

P^  power  (in  kilowatts), 
e  =  efficiency  as  a  ratio  <  1, 

Q  =  flow  (in  cfs),  and 
H  =  head  (in  feet)  on  the  power  plant. 

If  an  efficiency  factor  is  not  given  (either  as  a  constant 
or  tabulated  against  reservoir  level),  a  standard  value  of 
0.86  is  used.  Head  on  the  power  plant  is  the  reservoir 
stage  minus  a  constant  tailwater  elevation  minus  an 
optional  hydraulic  loss  either  expressed  in  feet  or  com¬ 
puted  as  follows: 

Hl  =  CQ2/64.4 

where 

Hl  =  hydraulic  loss  (in  feet), 

C  =  input  constant  to  be  specified  by  the  user, 
and 

Q  ==  flow  (in  cfs). 

This  head  loss  is  computed  only  approximately  for 
power  release  requirements,  assuming  that  outflow  re¬ 
quired  for  minimum  power  generation  is  met,  regardless 
of  other  requirements  or  reservoir  storage  limitations. 
Final  power  generation  quantities  are  based  on  losses 
computed  from  actual  river  releases  and  are  limited  by 
full  generation  capacity  for  the  period  with  a  load  factor 
of  1. 
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Table  5.2.  Options  in  the  RESYLD  Program. 

Option  Action 

lOC(l)  Determines  how  reservoir  releases  are  handled  to  meet  downstream  demand:  One  approach  is  to  use  the  buffer 

criteria  in  the  program;  the  second  approach  is  to  never  release  less  water  than  the  reservoir  inflow  when  the 
demand  is  not  met. 

0  “  Use  buffer  criteria. 

1  -  Set  release  to  inflow  when  demand  is  not  met. 

IOC(2)  Determines  the  way  a  shortage  is  handled. 

0  -  When  the  release  is  less  than  the  demand,  reduce  the  instream  flow  release  first  without  reducing  the 
diversicm,  until  no  water  is  released  for  instream  purposes. 

1  *  Reduce  the  diversion  and  instream  flow  in  equal  proportion  when  a  shortage  occurs. 

2  *  Reduce  the  diversion  first  until  no  diversion  occurs;  then  reduce  the  instream  flow. 

3  *  Similar  to  2,  except  for  an  absolute  minimum  level  for  the  diversion. 

4  =  Similar  to  0,  except  that  the  instream  release  is  reduced  to  a  specified  minimum  when  the  reservoir 

contents  are  reduced  below  some  specified  minimum  storage  level. 

5  “  When  the  reservoir  is  reduced  to  some  minimum  level,  the  diversion  and  instream  flows  are  reduced 

to  a  specified  ratio.  When  further  reduction  is  needed,  each  is  reduced  proportionately, 

IOC(3)  Allows  the  analyst  to  turn  off  the  buffer  control  or  releases  without  needing  to  change  the  input  file. 

0  =  Use  buffer  criteria. 

1  =  Do  not  use  buffer  criteria. 

IC>C(4)  The  evaporation  from  the  reservoir  can  be  charged  to  the  downstream  users  or  to  the  reservoir  owner. 

0  =  Downstream  diversion  is  reduced  by  the  evaporation  when  a  shortage  occurs. 

1  =  Reservoir  diversion  is  reduced  by  the  evaporation  when  a  shortage  occurs. 

IOC(5)  When  two  or  more  cycles  are  made  through  the  streamflow  data,  the  initial  reservoir  contents  can  be  reset  to  the 

original  data  set  or  to  the  value  at  the  end  of  the  previous  cycle. 

0  =  Use  initial  storage  given  in  input  file. 

1  “  Use  final  storage  from  previous  cycle  as  intended. 


Water  quality  computations  are  based  on  the  assump-  inflows  can  be  in  any  umts,  but  all  inflows  must  be  ex- 
tion  of  complete  mixing  in  the  reservoir  and  river.  Pro-  pressed  in  the  same  umts  of  volume  or  rate  of  flow, 

vision  is  made  only  for  maximum  temperature  of  con-  Required  flows  can  be  expressed  in  cfs  or  acre-feet;  how- 

centration  control-^ot  for  minimum.  This  provision  ever,  all  flows  and  required  flows  are  printed  out  in  cfs. 

could  be  added  easily,  however.  Water  rights  are  as-  Features  of  the  program  that  are  not  required  for  a 

sumed  to  be  limited  to  reservoir  inflow  minus  channel  problem  are  usually  automatically  omitted  when  the  vari- 

losses  plus  local  inflow.  Releases  for  quality  control  are  ables  pertinent  to  those  features  are  not  selected  in  the 
limited  by  outlet  and  channel  capacities  and  are  curtailed  RESIN  program. 

when  reservoir  concentration  exceeds  permissible  con-  There  are  two  output  files  from  the  RESYLD  program: 
centration  downstream.  ZRES,  which  contains  a  monthly  status  of  all  the  variables 

Shortage  indexes  are  computed  separately  for  releases  (river  and  pipe  flows  from  the  reservoir,  river  flow  down- 
to  pipeline;  for  releases  to  river;  for  power;  and  for  flow  at  stream,  reservoir  storage,  inflow,  elevation,  evaporation, 
a  downstream  control  point  (exclusive  of  water  rights),  surface  area,  unregulated  flow  downstream,  downstream 
The  shortage  index  is  the  sum  of  squares  of  annual  short-  water  rights,  and  power  production).  The  ZOUT  file  con- 
ages  expressed  as  a  ratio  to  annual  requirement,  divided  tains  monthly  and  annual  summaries  along  with  pipeline, 
by  the  number  of  years  of  record  to  give  an  annual  average,  outlet,  downstream,  and  power  shortage  indices.  All  stor- 
then  multiplied  by  100  to  give  a  percentage.  ages  and  evaporation  output  are  in  acre-feet;  flows  and  loss 

Input  to  the  RESYLD  program  is  an  input  file  created  by  is  in  cubic  feet  per  second  (cfs);  and  power  is  in  thousands 
the  RESIN  program.  All  storages  are  in  acre-feet  and  of  kilowatts  per  hour. 
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Other  programs  used  in  conjunctim  with  the  RES  YLD 

program  are 

resin  —  Creates  an  input  file  for  the  RESYLD 
program. 

CHGMIN  —  Oranges  the  minimum  flow  values  for  the 
river  at  the  dam,  the  pipe  at  the  dam,  and 
the  river  at  the  downstream  control  point  in 
the  RESYLD  input  file. 

RESYI  —  Computes  the  yield  index  for  a  reservoir 
from  a  RESYLD  input  and  a  monthly  time 
series  file  with  reservoir  surface  area  or 
storage  volume  values. 

RSTOMQ  —  Converts  the  ZRES  file  (output  from 
RESYLD)  to  a  multirecord  monthly  flow 
file.  This  conversion  enables  the  informa¬ 
tion  from  RESYLD  to  be  further  analyzed 
using  the  programs  presented  in  Chapters 
6-^9. 

Figure  5.8  shows  the  flow  of  information  through  the 

RESYLD  program. 


Running  RESYLD 

RRESYLD,  ZRESIN,  ZRES,  ZOUT 

ZRJESIN**  RESYLD  input  file  created  by  the 
RESIN  pogram  (input). 

ZRES*  RESYLD  output  file  containing  pipe  and 
river  flows  from  the  reservoir,  river  flow 
downstream,  reservoir  storage,  inflow, 
elevation,  evaporation,  surface  area,  un¬ 
regulated  flow  downstream,  down¬ 
stream  water  rights,  and  power  produc¬ 
tion  (output). 

ZOUT“  RESYLD  results  (output). 

Figure  5.9  is  a  sample  ZRES  output  file  from  RESYLD; 
Fig.  5.10  is  a  sample  ZOUT  file.  Table  5.3  contains  defi¬ 
nitions  of  the  variables  in  the  RESYLD  output. 


Fig.  5.8.  Flow  of  information  through  the  RESYLD  program. 
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MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 
MIN  RIVER  “  20,  PIPE  VARIABLE 


90/06/25 

10.47 , 

.50. 

STATION 

NUMBER;  QR9 11000 

YEAR 

QPIPE 

QRIVER 

QD 

STORB 

INFLOW 

D/SNAT 

ELEV 

EVAPA 

AREA 

RIGHTS 

POWER 

1940 

10 

30.00 

20.00 

20.00 

158356  . 

0.00 

0.00 

1036.52 

1569.93 

7136.06 

0.00 

0.00 

1940 

11 

30.00 

20.00 

20.00 

153814. 

0.00 

0.00 

1035.91 

1566  .72 

6989.12 

0.00 

0.00 

1940 

12 

30.00 

20.00 

20.00 

150465. 

0.00 

0.00 

1035.38 

274.44 

6861.12 

0.00 

0.00 

1940 

1 

30.00 

30.00 

30.00 

146736  . 

0.00 

0.00 

1034.78 

39.35 

6745.10 

0.00 

0.00 

1940 

2 

30.00 

30.00 

30.00 

143216  . 

•0.00 

0.00 

1034.23 

187 .74 

6626.29 

0.00 

0.00 

1940 

3 

30.00 

40.00 

40.00 

137708. 

0.00 

0.00 

1033.35 

1203.88 

6478.30 

0.00 

0.00 

1940 

4 

30.00 

50.00 

50.00 

131241. 

0.00 

0.00 

1032.32 

1706.61 

6282.02 

0.00 

0.00 

1940 

5 

30.00 

50.00 

50.00 

126231. 

0.00 

0.00 

1031.53 

91.41 

6093.88 

0.00 

0.00 

1940 

6 

30.00 

50.71 

51.00 

120898  . 

7.28 

7 .57 

1030.68 

962.70 

5924.35 

1.00 

0.00 

1940 

7 

30.00 

50.00 

54.58 

119318. 

114.62 

119.21 

1030.43 

3709.37 

5811.04 

1.00 

0.00 

1940 

8 

30.00 

20.48 

21.00 

114873. 

12.96 

13.48 

1029.67 

2137.34 

5712.28 

1.00 

0.00 

1940 

9 

30.00 

20.32 

20.33 

110922  . 

0.32 

0.33 

1028.91 

976.60 

5580.62 

0.33 

0.00 

Fig.  5.9.  Sample  output  (ZRES)  from  the  RES  YLD  program.  This  data  would  be  calculated  for  each  year  being  analyzed. 


PROGRAM  -  RESYLD  DATE  -  90/06/25.  TIME  -  10.47.50.  PAGE  -  1 

MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 


PRINCIPLE  CONTROL  VARIABLES 


NYRS 

lYR 

NPER 

I  PER 

NDYS 

NSTOR 

NCYCL  lACFT 

NCMP 

IPRNT 

39 

1940 

12 

10 

-1 

21 

1  0 

2 

0 

STORl 

CONST 

QOMN 

QMN2 

QOMX 

QDMN 

QDMX  QRTS  EFLT 

QULD 

163000. 

-1.00 

-1. 

-1. 

-1. 

-1. 

-1.  -1.  0. 

0. 

QUR 

STMX 

STMN 

STMN2 

PWR 

PWRMX 

EFFCY  TLWEL  QCAP 

EVAP 

0. 

-1. 

-1. 

-1. 

0. 

0. 

0.000  0.  -1. 

-1. 

ALOSS  CLOSS  HYDLS  FULRS  OVLOD 
0.  0.0000  0.00000  619360.  1.000 


IOC  01010000000000000000 

STORAGE,  AREA,  AND  ELEVATION  TABLE 


STORAGE  AREA  ELEVATION 


0.00 

0.00 

959.00 

58.40 

20.80 

964 . 00 

269.70 

52.00 

970.00 

608.90 

71 . 10 

976.00 

1373 . 00 

225.20 

982.00 

37  87 .00 

597.40 

988.00 

8688 . 00 

1035.00 

994.00 

16300.00 

1511.00 

1000.00 

26722 . 00 

1985.00 

1006.00 

40551.00 

2704.00 

1012.00 

59843 . 00 

3744.00 

1018.00 

85384.00 

4723.00 

1024.00 

116599.00 

5696.00 

1030.00 

154393.00 

6935.00 

1036 .00 

200313.00 

8404.00 

1042.00 

255775.00 

10165.00 

1048.00 

299260.00 

11667.00 

1052.00 

349110 . 00 

14442.00 

1058.00 

472668 . 00 

17436 .00 

1064.00 

587216.00 

20806.00 

1070.00 

630072.00 

22061.00 

1072.00 

OUTLET  CAPACITY  TABLE 

OUTLET  CAPACITY 

STORAGE 

0.00 

154394.00 

2200.00 

161562.00 

2200.00 

224106.00 

3500.00 

233325.00 

3500.00 

293638.00 

4500.00 

305230.00 

4500.00 

363556 , 00 

5500.00 

399669.00 

14500.00 

459656.00 

34500.00 

619358.00 

Fig.  5.10.  Sample  output  (ZOUT)  from  RESLYD. 
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PROGRAM  -  RESYLD  DATE  -  90/06/25.  TIME  -  10.47.50.  PAGE  -  4 

MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 


YEAR:  1940  CYCLE:  1 


CFS 

END 

OF  MONTH 

STORAGE 

IN  AC -FT 

AC -FT 

CFS 

TO  PIPELINE 

RELEASE  TO 

RIVER 

IN  CFS 

RES 

PER 

INFLOW 

MIN 

BUFFER 

ACTUAL 

MAX 

EVAP 

REQ  ACTUAL 

SHRTG 

REQ 

ACTUAL 

SHRTG 

MAX  CASE 

QUAL 

10 

0. 

26000. 

100000. 

158356 . 

163000. 

1570. 

30. 

30. 

0. 

20, 

20. 

0. 

7000 

4 

0 

11 

0. 

26000. 

100000. 

153814 . 

163000. 

1567  . 

30. 

30. 

0. 

20, 

20. 

0. 

7000 

4 

0 

12 

0. 

26000. 

100000. 

150465. 

163000. 

274  . 

30. 

30. 

0. 

20, 

20. 

0. 

7000 

4 

0 

1 

0. 

26000. 

100000. 

146736. 

163000. 

39  . 

30. 

30. 

0. 

30, 

30. 

0. 

7000 

4 

0 

2 

0. 

26000. 

100000. 

143216 . 

163000. 

188. 

30. 

30. 

0. 

30. 

30. 

0. 

7000 

4 

0 

3 

0. 

26000. 

100000. 

137708. 

163000. 

1204  . 

30. 

30. 

0. 

40, 

40. 

0. 

7000 

4 

0 

4 

0. 

26000. 

100000. 

131241. 

163000. 

17  07  . 

30. 

30. 

0. 

50 

50. 

0. 

7000 

4 

0 

5 

0. 

26000. 

100000. 

126231. 

163000. 

91. 

30. 

30. 

0. 

50 

50. 

0. 

7000 

4 

0 

6 

7. 

26000. 

100000. 

120898. 

163000. 

963. 

30. 

30. 

0. 

50 

51. 

0. 

7000 

4 

0 

7 

115. 

26000. 

100000. 

119318. 

163000. 

37  09. 

30. 

30. 

0. 

50 

50. 

0. 

7000 

5 

0 

8 

13  . 

26000. 

100000. 

114873. 

163000 . 

2137  . 

30. 

30. 

0. 

20 

20. 

0. 

7000 

4 

0 

9 

0. 

26000. 

100000. 

110922. 

163000. 

977  . 

30. 

30. 

0. 

20 

20. 

0. 

7000 

4 

0 

YR 

11. 

14426 

.  30. 

30. 

0. 

33 

33. 

0. 

7000 

1000 

KW-HR 

POWER 

FLOW 

IN  CFS  AT 

DOWNSTREAM 

CONTROL 

POINT 

DOWNSTREAM 

QUALITY 

PER 

REQ 

ACTUAL 

SHRTG 

QLOCAL 

RIGHTS  ADD 

REQ 

ACTUAL 

SHRTG 

MAX 

EFLT 

REQ 

ACTUAL 

10 

0. 

0. 

0. 

0  . 

0. 

20. 

20. 

0. 

7000. 

0  . 

0. 

0. 

11 

0. 

0. 

0. 

0. 

0. 

20. 

20. 

0. 

7000  . 

0. 

0. 

0. 

12 

0. 

0. 

0. 

0  . 

0  . 

20. 

20  . 

0. 

7000  . 

0. 

0. 

0  . 

1 

0. 

0. 

0. 

0. 

0. 

30. 

30  . 

0. 

7000  . 

0. 

0. 

0. 

2 

0. 

0. 

0. 

0. 

0. 

30. 

30. 

0. 

7000. 

0. 

0. 

0. 

3 

0  . 

0. 

0. 

0  . 

0. 

40. 

40  . 

0. 

7000  . 

0. 

0. 

0  . 

4 

0  . 

0. 

0. 

0. 

0. 

50. 

50. 

0. 

7000. 

0  . 

0. 

0. 

5 

0  . 

0. 

0. 

0. 

0. 

50. 

50. 

0. 

7000. 

0  . 

0. 

0. 

6 

0. 

0. 

0. 

0. 

1. 

50. 

51. 

0. 

7000. 

0  . 

0. 

0. 

7 

0. 

0. 

0. 

5. 

1. 

50. 

55. 

0. 

7000. 

0  . 

0. 

0. 

8 

0. 

0. 

0. 

1 . 

1. 

20. 

21 . 

0. 

7000  . 

0  . 

0. 

0. 

9 

0. 

0. 

0. 

0. 

0. 

20. 

20  . 

0. 

7000. 

0  . 

0. 

0. 

YR 

0. 

0. 

0. 

0. 

0. 

33. 

34  . 

0. 

7000. 

0. 

0. 

0. 

This  data  would  be  calculated  for  each  year  being  analyzed. 
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GRAND  AVERAGE  FOR  CYCLE  1 


CFS 

END 

OF  MONTH 

STORAGE 

IN  AC -FT 

AC -FT 

CFS  TO  PIPELINE 

RELEASE  TO  RIVER  IN 

CFS 

RES 

PER 

INFLOW 

MIN 

BUFFER 

ACTUAL 

MAX 

EVAP 

REQ  ACTUAL  SHRTG 

REQ  ACTUAL  SHRTG 

MAX  CASE 

QUAL 

YR 

174  . 

26260. 

184844 

.  14929 

30.  28.  2. 

33.  125.  2. 

7000. 

1000  KW-HR  POWER  FLOW  IN  CFS  AT  DOWNSTREAM  CONTROL  POINT  DOWNSTREAM  QUALITY 


PER 

REQ 

ACTUAL 

SHRTG 

QLOCAL 

RIGHTS 

ADD  REQ 

ACTUAL 

SHRTG 

MAX 

EFLT 

REQ 

ACTUAL 

YR 

0. 

0. 

0. 

117  . 

1 . 

33  . 

242. 

2. 

7000  . 

0  . 

0. 

0. 

SHORTAGE  INDEX,  PIPELINE  4.100  OUTLET  4.121  DOWNSTREAM  4.093  POWER  0.000 

PIPE  SHORTAGE:  792958.  AC. -FT. 

RIVER  SHORTAGE:  3539654.  AC. -FT. 

DOWNSTREAM  SHORTAGE :  60435.  AC. -FT. 

AVERAGE  ANNUAL  STORAGE  USE: 

PIPE  5943764.50  CFS 

RIVER  9487258.  CFS 


Fig.  5.10.  Continued. 
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Table  53.  Definitions  of  the  variables  in  the  RESYLD  output 
Variable  Definition 

ALOS  Constant  loss  component  between  reservoir  and  downstream  control  point,  for  each  period,  in  cubic 

feet  per  second  (cfs), 

ALOSS  Constant  loss  component  between  reservoir  and  downstream  control  point,  for  all  periods  in  cfs.  Calling 

index  if  negative. 

AREA  Reservoir  area  in  acres  in  reservoir  contents  table. 

CASE  Index  of  the  restriction  being  considered. 

CLOSS  Loss  coefficient  applied  to  flow  remaining  after  ALOS  is  subtracted  to  obtain  remaining  loss  between 
reservoir  and  downstream  control  point. 

CONST  Conversion  factor  from  inflow  units  to  acre-feet  (if  flow  units  are  volumes)  and  from  inflow  units  per 
day  to  cfs  (if  flow  units  are  rates). 

D/SNAT  Estimate  of  downstream  flow  without  project. 

EFFCY  Plant  efficiency  ratio,  calling  index  if  negative. 

EFLT  Effluent  in  tons  per  day  discharges  for  one  period  into  river  between  reservoir  and  downstream  control 

point. 

ELEV  Reservoir  elevation  in  stage  table  (in  feet). 

EVAP  Reservoir  evaporation  net  change  to  project  conditions  (in  inches  per  year),  calling  index  if  negative. 

EVAPA  Reservoir  evaporation  (net  change  to  project  conditions)  for  period  (in  acre-feet). 

FULRS  Reservoir  capacity  at  full  pool. 

HYDLS  Hydraulic  head  loss,  coefficient  in  equation  Hloss  =  (HYDLS)/Q^/2g  if  positive;  if  negative,  loss  in 
feet. 

lACFT  Positive  integer  indicates  flow  requirements  are  in  acre-feet;  zero  indicates  flow  requiiements  are  in 

cubic  feet  per  second, 

INFLOW  Flow  from  inflow- versus-quality  table. 

IPER  Number  of  first  period  in  each  year. 

IPRNT  Indicates  whether  or  not  to  print  yearly  statistics. 

I YR  Year  number. 

NCMP  Number  of  cycles  completed. 

NCYCL  Number  of  cycles  for  job. 

NDYS  Number  of  days  in  each  period  if  same  for  all  periods,  calling  index  if  negative. 

NPER  Number  of  routing  periods  per  year. 

NSTOR  Number  of  storage  values  in  table. 

NYRS  Number  of  years  in  each  run. 

OVLOD  Maximum  permissible  power  generated  as  a  multiple  of  installed  capacity. 

POWER  Power  (in  thousand  kilowatts  per  hour)  actually  generated  in  one  period. 

PWR  Minimum  power  (in  thousand  kilowatts  per  hour)  required  per  period  if  same  for  all  periods,  calling 

index  if  negative. 

PWRMX  Maximum  permissible  generation  (in  kilowatts). 

QCAP  Outlet  capacity  (in  cfs). 

QD  Actual  flow  at  downstream  control  point,  including  all  water  rights. 

QDMN  Minimum  permissible  flow  for  period  at  downstream  control  point,  excluding  water  rights. 
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Table  5.3.  Continued. 

Variable  Definition 

QDMX  Maximum  pennissible  fiow  at  downstream  control  point  for  each  period  if  same  fOT  all  periods,  including 

water  rights,  calling  index  if  negative. 

QLOCAL  Includes  effect  of  water  rights  (calculated  local  inflow  need). 

QMN2  Minimum  required  outflow  to  pipeline  for  each  period  if  same  for  all  periods  (see  input  data  for  units), 

calling  index  if  negative. 

QOMN  Minimum  required  outflow  to  river  for  each  period  if  same  for  all  periods  (see  input  data  for  units), 

calling  index  if  negative. 

(JOMX  Maximum  permissible  outflow  (in  cfs)  to  river  for  each  period  if  same  for  all  periods,  calling  index  if 

negative. 

QPIPE  Actual  reservoir  release  (in  cfs)  to  pipeline  for  period. 

QRTVER  Actual  reservoir  release  (in  cfs)  to  river  for  period. 

QKTS  Maximum  water  right  for  period  (see  input  data  for  units). 

QULD  Minimum  required  quality  at  downstream  control  point  for  each  period  if  same  for  all  periods  (in  parts 

per  million  or  degrees  of  temperature),  calling  index  if  negative. 

QUR  Reservoir  quality  for  period  (in  parts  per  million  or  degrees  of  temperature). 

RIGHTS  Required  flow  downstream  at  a  control  point. 

STMN  Minimum  storage  (in  acre-feet)  for  each  period  if  same  for  all  periods,  calling  index  if  negative. 

STMN2  Storage  (in  acre-feet)  greater  than  or  equal  to  STMN  below  which  shortage  is  declared,  for  each  period 

if  same  for  all  periods,  calling  index  if  negative. 

STMX  Maximum  storage  (in  acre-feet)  for  each  period  if  same  for  all  periods,  calling  index  if  negative. 

STOR 1  Storage  (in  acre-feet)  at  start  of  routing  cycle. 

STORE  Storage  (in  acre-feet)  at  end  of  period. 


TLWEL 


Tailwater  elevation  (in  feet). 
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RSTOMQ  Program 

Introduction 

The  RSTOMQ  program  converts  the  output  file  (ZRES) 
from  the  RES  YLD  program  to  a  multirecord  monthly  flow 
file.  This  conversion  enables  the  information  from 
RESYLD  to  be  further  analyzed  using  the  programs  pre¬ 
sented  in  Chapters  6-9, 

Running  RSTOMQ 

RRSTOMQ,  ZRES,  ZMONQ 

ZRES  =  RESYLD  output  file  (input). 

ZMONQ  *  Monthly  flow  file  in  USGS  or  NWDC 
format  (output). 

Figure  5. 1 1  is  a  sample  multirecord  ZMONQ  file  created 
by  the  RSTOMQ  program.  The  GETl  program  could  be 
used  to  extract  a  record(s)  for  further  analysis. 

'  0  for; 

_ 1  FOR  aSGS  FORMAT 


Specify  the  format  of  the  output  monthly  flow  file 
(ZMONQ). 


.RERVXJO  OOTPWP 
PIPE  FLOW  FROM  RESERVOIR 
■  RIVER  FLOW  FROM  RESERVOIR  At' OAm 
.  RIVER  FLOW  OOWWStRRWJ 
.  RESpgiVOIR  STORAGE 
RESERVOIR  INFLOW 
ONREGOIATED  FLOW  DOWNSTREAM 
RESERVOIR  ELEVAtlOW 
RESERVOIR  EVAPORATION 
RESERVOIR  SURFACE  AREA 
•  DOWNSTREAM  WATER  RIGHTS 
POWER  PRODUCTION* 

FOR  EACrt  SET  OF  RESVtO  OUTPUT  VALUES: 

EWTER  0  TO  SKIP  THE  CURRENT  SET  OF  VALUES 
X  TO  WRITE  THE  CURRENT  SET  OP  VALDES 
2  TO  WHITE  ALL  REMAINING  SETS  OF  VALUES 
T  TO  SKIP  THE  REMAINING  SET  OF  VALUES 

PIPE  FLOW  FROM  RESERVOIR  t 

Below  is  a  description  of  each  option.  Keep  in  mind  that 
the  actual  data  written  to  the  monthly  flow  file  depends  on 
the  point  at  which  you  enter  these  options.  At  this  point, 
pipe  flow  from  reservoir: 

If  0  is  selected:  Pipe  flow  values  will  not  be  written  to  the 
monthly  streamflow  file.  The  set  of  options  will  then  be 
displayed  for  river  flow  from  reservoir  at  dam. 

If  1  is  selected:  Pipe  flow  values  will  be  written  to  the 
monthly  streamflow  file;  then  the  set  of  options  will  be 
displayed  for  river  flow  from  reservoir  at  dam. 

If  2  is  selected:  All  data  from  the  ZRES  file  will  be  written 
to  the  monthly  streamflow  file  in  a  multirecord  format. 
No  more  prompts  will  be  displayed. 

If  3  is  selected:  Pipe  flow  from  reservoir  data  will  be  the 
only  data  written  to  the  monthly  flow  file.  No  more 
prompts  will  be  displayed. 


PIPE  FLOW 

MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 

QR911000  1940  1  30.00  30.00  30.00  30.00  30.00 

QR911000  1940  2  30.00  30.00  30.00  30.00  30.00 

QR911000  1941  1  30.00  30.00  30.00  30.00  30.00 

QR911000  1941  2  30.00  30.00  30.00  30.00  30.00 

#EOR 

RIVER  FLOW  FROM  RESERVOIR  AT  DAM 

MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 

QR911000  1940  1  20.00  20.00  20.00  30.00  30.00 

QR911000  1940  2  50.00  50.00  50.71  50.00  20.48 

QR911000  1941  1  20.00  20.00  20.17  30.00  30.00 

QR911000  1941  2  50.00  50.00  50.00  50.00  20.00 

#EOR 

RIVER  FLOW  DOWNSTREAM 

MELVERN  RESERVOIR  ROUTING  DATA  SET 
DATA  FROM  CORPS  OF  ENGINEERS 

QR911000  1940  1  20.00  20.00  20.00  30.00  30.00 

gR911000  1940  2  50.00  50.00  51.00  54.58  21.00 

gR911000  1941  1  20.00  21.44  21.00  487.70  33.06 

QR911000  1941  2  50.00  50.00  58.48  52.78  701.80 


30.00 

30.00 

30.00 

30.00 


40 . 00 
20.32 
40.00 
20.00 


40.00 
20.33 
42 . 10 
23.45 


Fig.  5.11.  Sample  output  from  the  RSTOMQ  program. 
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QABSDY  Program 


Introduction 

The  QABSDY  program  was  designed  to  simulate  the 
change  in  daily  streamflows  from  a  diversion  (abstraction) 
from  a  river.  QABSDY  subtracts  a  diversion  flow  by  day 
from  a  daily  streamflow  file  while  leaving  a  user-specified 
minimum  flow  in  the  main  stream. 

Running  QABSDY 

RQABSDY,  ZDQ,  ZDQD,  ZDQR,  ZDQN,  ZOUT 

ZDQ“  Daily  streamflow  file  in  WATSTORE 
format  or  a  free-formatted  file  with  stream- 
flows  and  dates  (input). 

ZDQD  *  Diversion  streamflows  in  daily  flow  file 
format,  or  a  free-formatted  file  with  di¬ 
version  flows  and  dates  (input). 

ZDQR=  Required  minimum  instream  stream- 
flows  in  daily  flow  file  format  or  a  free- 
formatted  file  with  required  instream 
flows  and  dates  (input). 

ZDQN  “  Daily  streamflow  file  with  flows  left  af¬ 
ter  the  diversion  (output). 

ZOUT=  QABSDY  results,  including  annual 
shortages  and  diversions  (output). 

The  file  format  for  the  free-formatted  ZDQ,  ZDQD,  and 
ZDQR  file  is 

Line  1 — Title  line  1 

Line  2 — Title  line  2 

Line  3 — ^Year  number  and  how  many  data  points  will  be 
entered. 

Data  for  the  first  and  last  days  of  the  year  must  be 
entered.  Data  for  days  not  entered  will  be  interpolated  from 
the  supplied  data. 


Line  4^:  Streamflow  data  for  the  number  of  data  points 
specified  on  Line  3. 

month  day  flow  month  day  flow  month  day  flow  [etc.] 
Sample  free-formatted  file: 

FREE  FORMATTED  FILE  FOR  DAILY  FLOW  FILES  (ZDQ,  ZDQD,  and  ZDQR) 
FOR  USE  WITH  THE  QABSDY  PROGRAM 

1971  12 

10  1  300  11  1  300  12  1  300  1  1  300  2  1  300  3  1  300  4  1  400 
5  1  450  6  1  450  6  1  450  7  1  450  8  1450  9  1  450 

1972  300 

10  1  300  .  9  1  450 

The  two  title  lines  from  the  daily  streamflow  file  (ZDQ) 
with  the  measured  flows  will  be  displayed. 

INITIAL  FLOW  FILE  FORMAT: 

ENTER  0  FOR  DAILY  FLOW  FILE  FORMAT 

_ 1  FOR  FREE -FORMATTED  POINT  FILE""-'' _ 


The  daily  flow  file  format  is  a  daily  streamflow  file  in 
WATSTORE  format  with  a  value  entered  for  each  day  of 
the  year.  The  free-formatted  flow  point  file  may  or  may 
not  contain  data  for  each  day  of  the  year.  Streamflows  for 
days  not  supplied  will  be  interpolated  from  the  data  sup¬ 
plied. 

The  two  title  lines  from  the  diversion  data  file  (ZDQD) 
will  be  displayed. 

DIVERSION  FLOW  FILE  FORMAT: 

ENTER  0  FOR  DAILY  FLOW  FILE  FORMAT  ’ 

1  FOR  FREE -FORMATTED  FLOW  POINT  FILE _ 7 


The  two  title  lines  from  the  flow  requirement  file 
(ZDQR)  will  be  displayed. 


REQUIRED  MINIMUM  FLOW  FILE  FORMAT; 

:ENTER  0  FOR  DAILY  FLOW  FILE  FORMAT  . 

.  1  FOR  FREE -FORMATTED  FLOW  POINT  FILE  .  vx 

ENTER  1  TO  LIST  DAILY  VALUES 

•Vi::..-  2  TO  LIST  MONTHLY  AVERAGES  ONLY  "  ...  1.-: 


If  1  is  entered  to  list  daily  values,  a  table  will  be  gener¬ 
ated  for  each  year  with  the  original  flow,  diversion  flow, 
and  required  flow  for  each  day  of  the  year. 

If  2  is  entered  to  list  only  monthly  averages,  the  output  will 
be  similar  to  the  QABSMN  program  output  (Fig.  5.12). 
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QABSMN  Program 


Introduction 

The  QABSMN  program  was  designed  to  simulate  the 
change  in  monthly  streamflows  from  a  diversion  (abstrac¬ 
tion)  from  a  river.  QABSMN  subtracts  a  diversion  flow  by 
month  from  a  monthly  streamflow  file  while  leaving  a 
user-specified  minimum  fiow  in  the  main  stream. 

For  example,  an  irrigation  company  proposes  to  divert  a 
set  amount  of  flows  from  a  stream  each  month.  An  in- 
stream  flow  analysis  has  determined  the  required  flows  per 
month  to  maintain  the  habitat  area.  The  QABSMN  pro¬ 
gram  could  be  run  to  determine  if  and  where  a  conflict  will 
arise,  considering  the  history  of  the  monthly  flows  for  that 
section  of  the  stream. 

The  monthly  streamflow  data  may  be  in  either  NWDC 
or  uses  format.  The  program  will  write  a  file  of  monthly 
flows  (Qds)  downstream  of  the  diversion  in  the  same 
format  as  the  file  of  monthly  flows  supplied. 

Running  QABSMN 

RQABSMN,  ZMONQ,  ZMONQN,  ZOUT 

ZMONQ  =  Monthly  streamflow  file  in  USGS  or 
NWDC  format  (input). 

ZMIONQN  ”  Monthly  streamflow  file  in  the  same  for¬ 
mat  as  the  ZMONQ  input  file,  with  di¬ 
version  flows  subtracted  from  the 
monthly  flows  (output). 


■  EMTER  IMDEX  TO  FIRST  OF  DATA  <OCT.  Id,  *  1)  t 

This  index  will  label  the  first  data  entry  on  the  input 
streamflow  file  with  the  corresponding  month  name.  For 
example,  if  the  first  monthly  entry  on  the  streamflow  file 
is  October,  enter  10.  If  the  first  entry  on  the  data  file  is 
January,  enter  1. 


gWTER  12  MONTHLY  DIVERSION  DEMANDS: 


Enter  the  monthly  flows  that  the  diversion  is  proposing. 


To  repeat  a  number,  enter  repeat  factor*value. 

Example:  6*250  =  entering  250  six  times. 


ENTER  MIKIMOM  REQUIREMEtfr  INSTREAM  FtOW  NEEDS: _ 

Enter  the  12  monthly  flows  that  are  needed  to  support 
the  habitat.  Again,  to  repeat  a  number,  enter  repeat  fac- 
tor*value. 

Tlie  average  annual  diversion  (in  acre-feet),  aii  annual 
diversion-versus-year  plot,  and  the  average  annual  diver¬ 
sion  shortage  (in  acre-feet)  are  displayed  on  the  screen. 
Figure  5.12  contains  sample  output  from  the  ZOUT  file 
from  the  QABSMN  program;  Fig.  5. 13  is  a  ZMONQN  file 
from  QABSMN. 


ZOUT=  QABSMN  results,  including  aimual 
shortages  and  diversions  (output). 
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DATE  -  90/06/18. 
TIME  -  13.42.53. 


NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH 
MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977 


1214200000 


PROGRAM  -  QABSMN 
PAGE  -  1 


DIVERSION 

INSTREAM  FLOW 

MONTH 

TARGET 

REQUIREMENT 

OCT 

250.00 

300.00 

NOV 

250.00 

300.00 

DEC 

250.00 

300.00 

JAN 

250.00 

300.00 

FEB 

250.00 

300.00 

MAR 

250.00 

300.00 

APR 

275.00 

400.00 

MAY 

300.00 

450.00 

JUNE 

300.00 

450.00 

JULY 

300.00 

450.00 

AUG 

300.00 

450.00 

SEPT 

275.00 

450.00 

DATE  -  90/06/18. 
TIME  -  13.42.53. 


NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH 
MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977 


1214200000 


PROGRAM  '  QABSMN 
PAGE  -  2 


GIVEN  MONTHLY  FLOWS 


YEAR 

OCT 

NOV 

DEC 

JAN 

FEB 

1962 

523 . 00 

479.00 

715.00 

865.00 

363.00 

1963 

300.00 

721.00 

748.00 

421.00 

686.00 

1964 

315.00 

751.00 

549.00 

668.00 

380.00 

1965 

365.00 

568.00 

742.00 

920.00 

771.00 

1966 

352 . 00 

475.00 

429.00 

543.00 

275.00 

1967 

405.00 

605.00 

999.00 

1054 . 00 

572.00 

1968 

760.00 

488.00 

996.00 

853.00 

917 .00 

1969 

578.00 

736.00 

603.00 

732.00 

201.00 

1970 

413.00 

377.00 

498.00 

713.00 

545.00 

1971 

364.00 

589.00 

480.00 

938.00 

834.00 

1972 

374.00 

788.00 

537.00 

651.00 

1125.00 

1973 

171.00 

392.00 

972.00 

577 . 00 

219.00 

1974 

431.00 

574.00 

805.00 

1105.00 

453.00 

1975 

51.00 

528.00 

768.00 

919.00 

439.00 

1976 

518.00 

962.00 

1556.00 

996.00 

343 . 00 

1977 

153.00 

388.00 

485.00 

500.00 

325.00 

AVE 

379.56 

588.81 

742.62 

778.44 

528.00 

C.V. 

0.4527 

0.2801 

0.3875 

0.2663 

0.5110 

UNITS  ARE  CUBIC  FEET  PER  SECOND 


MAR 

APR 

MAY 

JUNE 

JULY 

243.00 

709.00 

510.00 

568 . 00 

318.00 

314.00 

523.00 

456.00 

394.00 

247.00 

412.00 

533.00 

846 . 00 

1219.00 

692.00 

329.00 

637.00 

587 . 00 

461.00 

222 . 00 

472.00 

666.00 

798.00 

599 . 00 

424.00 

389 . 00 

284 . 00 

747 . 00 

771.00 

244.00 

428.00 

479.00 

682.00 

705.00 

221.00 

408.00 

625.00 

1013.00 

764 . 00 

249 . 00 

391.00 

523.00 

540.00 

536.00 

182.00 

397 . 00 

444 . 00 

1054.00 

875.00 

717.00 

1250.00 

682.00 

1170.00 

998.00 

733.00 

275.00 

353.00 

523.00 

493 . 00 

162.00 

670.00 

620.00 

877 .00 

1338 . 00 

725.00 

428.00 

279.00 

854 . 00 

802.00 

564.00 

244 . 00 

480.00 

785.00 

645.00 

491.00 

332.00 

605.00 

535.00 

439.00 

142.00 

436.37 

527.62 

748.56 

725.44 

395.81 

0.5497 

0.2567 

0.2875 

0.3774 

0.5647 

AUG  SEPT 

281.00  197 .00 
125.00  149.00 
439.00  405.00 
146.00  243.00 
120.00  78.00 

71.00  73.00 

238.00  462.00 
90.00  401.00 
90.00  359.00 
177 .00  208.00 
181.00  69.00 

64.00  145.00 
263.00  92.00 

307.00  163.00 
323.00  157.00 
141.00  262.00 

191.00  235.19 
0.5623  0.5405 


MONTHLY  DIVERSION 


YEAR 

OCT 

NOV 

DEC 

JAN 

FEB 

MAR 

1962 

223.00 

179 .00 

250.00 

250.00 

63.00 

0.00 

1963 

0.00 

250.00 

250.00 

121.00 

250.00 

14 .00 

1964 

15.00 

250.00 

249 . 00 

250.00 

80.00 

112.00 

1965 

65.00 

250.00 

250,00 

250.00 

250.00 

29.00 

1966 

52.00 

175.00 

129.00 

243.00 

0.00 

172.00 

1967 

105.00 

250,00 

250.00 

250.00 

250.00 

89 .00 

1968 

250.00 

188.00 

250.00 

250.00 

250.00 

128.00 

1969 

250.00 

250.00 

250.00 

250.00 

0.00 

108.00 

1970 

113.00 

77 . 00 

198.00 

250.00 

245.00 

91.00 

1971 

64.00 

250.00 

180.00 

250.00 

250.00 

97.00 

1972 

74.00 

250.00 

237 . 00 

250.00 

250.00 

250.00 

1973 

0.00 

92.00 

250.00 

250.00 

0.00 

0.00 

1974 

131.00 

250.00 

250.00 

250.00 

153.00 

250.00 

1975 

0.00 

228.00 

250.00 

250.00 

139.00 

128.00 

1976 

218.00 

250.00 

250.00 

250.00 

43.00 

0.00 

1977 

0.00 

88.00 

185.00 

200.00 

25.00 

32.00 

AVE 

97 .50 

204 . 81 

229 . 87 

238.37 

140.50 

93  .75 

C.V 

0.9468 

0.317 

0.1595 

0.1413 

0.7682 

0.8648 

UNITS  ARE  CUBIC  FEET  PER  SECOND 


APR 

MAY 

JUNE 

JULY 

AUG 

SEPT 

275.00 

60.00 

118.00 

0.00 

0.00 

0.00 

123.00 

6.00 

0.00 

0.00 

0.00 

0.00 

133.00 

300.00 

300.00 

242.00 

0.00 

0.00 

237.00 

137.00 

11.00 

0.00 

0.00 

0.00 

266.00 

300.00 

149.00 

0.00 

0.00 

0.00 

0.00 

297.00 

300.00 

0.00 

0.00 

0.00 

79.00 

232.00 

255.00 

0.00 

0.00 

12.00 

225.00 

300.00 

300.00 

0.00 

0.00 

0.00 

123.00 

90.00 

86 . 00 

0.00 

0.00 

0.00 

44.00 

300,00 

300.00 

267.00 

0.00 

0.00 

275.00 

300.00 

300.00 

283.00 

0.00 

0.00 

0.00 

73.00 

43,00 

0.00 

0.00 

0.00 

220.00 

300.00 

300.00 

275.00 

0.00 

0.00 

0.00 

300.00 

300.00 

114.00 

0.00 

0.00 

80.00 

300.00 

195.00 

41.00 

0.00 

0.00 

205.00 

85.00 

0.00 

0.00 

0.00 

0.00 

142.81 

211.25 

184 . 81 

76.37 

0.00 

0  .75 

0.7128 

0.5343 

0.6730 

1.5378 

0.0000 

4.0000 

Fig.  5.12.  Sample  output  (ZOUT)  file  from  the  QABSMN  program. 
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DATE  -  90/06/18.  NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000  PROGRAM  -  QABSMN 
TIME  -  13.42.53.  MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977 


SHORTAGE  TABLE 


YEAR 

OCT 

NOV 

DEC 

JAN 

FEB 

MAR 

APR 

MAY 

JUNE 

JULY 

AUG 

SEPT 

1962 

27 . 00 

71.00 

0.00 

0.00 

187 . 00 

250.00 

0.00 

240.00 

182.00 

300.00 

300.00 

275.00 

1963 

250.00 

0.00 

0.00 

129.00 

0.00 

236.00 

152.00 

294.00 

300.00 

300.00 

300.00 

275.00 

1964 

235.00 

0.00 

1.00 

0.00 

170.00 

138.00 

142.00 

0.00 

0.00 

58.00 

300.00 

275.00 

1965 

185.00 

0.00 

0 .00 

0.00 

0.00 

221.00 

38.00 

163.00 

289 . 00 

300.00 

300.00 

275.00 

1966 

198.00 

75.00 

121.00 

7.00 

250.00 

78.00 

9.00 

0.00 

151.00 

300.00 

300.00 

275.00 

1967 

145.00 

0.00 

0.00 

0.00 

0.00 

161.00 

275.00 

3.00 

0.00 

300.00 

300.00 

275.00 

1968 

0.00 

62.00 

0.00 

0.00 

0.00 

122.00 

196.00 

68.00 

45.00 

300.00 

300.00 

263.00 

1969 

0.00 

0.00 

0.00 

0.00 

250.00 

142.00 

50.00 

0.00 

0.00 

300.00 

300.00 

275.00 

1970 

137.00 

173.00 

52.00 

0.00 

5.00 

159.00 

152.00 

210.00 

214.00 

300.00 

300.00 

275.00 

1971 

186 . 00 

0.00 

70.00 

0 . 00 

0.00 

153.00 

231.00 

0.00 

0.00 

33.00 

300.00 

275.00 

1972 

176.00 

0.00 

13.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

17.00 

300.00 

275.00 

1973 

250.00 

158.00 

0.00 

0.00 

250.00 

250.00 

275.00 

227.00 

257.00 

300.00 

300.00 

275.00 

1974 

119.00 

0.00 

0.00 

0.00 

97 .00 

0.00 

55.00 

0.00 

0.00 

25.00 

300,00 

275.00 

1975 

250.00 

22.00 

0.00 

0.00 

111.00 

122.00 

275.00 

0.00 

0.00 

186.00 

300.00 

275.00 

1976 

32.00 

0.00 

0.00 

0.00 

207.00 

250.00 

195.00 

0.00 

105.00 

259.00 

300.00 

275.00 

1977 

250.00 

162.00 

65.00 

50.00 

225.00 

218.00 

70.00 

215.00 

300.00 

300.00 

300.00 

275.00 

AVE 

152.50 

45.19 

20.12 

11.62 

109.50 

156.25 

132.19 

88.75 

115.19 

223.62 

300.00 

274.25 

C.V. 

0.6054 

1.4394 

1.8216 

2.8983 

0.9857 

0.5189 

0 .7701 

1.2717 

1.0798 

0.5252 

0.0000 

0.0109 

UNITS  ARE  CUBIC  FEET  PER  SECOND 


MONTHLY  INSTREAM  FLOWS 


YEAR 

OCT 

NOV 

DEC 

JAN 

FEB 

MAR 

APR 

MAY 

JUNE 

JULY 

AUG 

SEPT 

1962 

300.00 

300.00 

465.00 

615.00 

300 . 00 

243.00 

434 .00 

450.00 

450.00 

318.00 

281.00 

197 .00 

1963 

300 . 00 

471.00 

498.00 

300.00 

436.00 

300.00 

400.00 

450.00 

394.00 

247.00 

125.00 

149.00 

1964 

300.00 

501.00 

300.00 

418.00 

300.00 

300.00 

400.00 

546.00 

919.00 

450.00 

439.00 

405.00 

1965 

300.00 

318 . 00 

492 .00 

670.00 

521.00 

300 . 00 

400.00 

450.00 

450.00 

222.00 

146 . 00 

243.00 

1966 

300.00 

300.00 

300.00 

300.00 

275.00 

300.00 

400.00 

498.00 

450.00 

424.00 

120.00 

78.00 

1967 

300 . 00 

355.00 

749.00 

804.00 

322.00 

300.00 

284.00 

450.00 

471.00 

244 . 00 

71.00 

73 .00 

1968 

510.00 

300.00 

746.00 

603.00 

667.00 

300.00 

400.00 

450.00 

450.00 

221.00 

238.00 

450.00 

1969 

328 . 00 

486 . 00 

353.00 

482.00 

201.00 

300.00 

400.00 

713.00 

464 . 00 

249.00 

90.00 

401.00 

1970 

300 . 00 

300.00 

300.00 

463.00 

300.00 

300.00 

400.00 

450.00 

450.00 

182.00 

90.00 

359.00 

1971 

300 . 00 

339.00 

300.00 

688.00 

584 .00 

300.00 

400.00 

754 . 00 

575.00 

450.00 

177 .00 

208.00 

1972 

300.00 

538.00 

300.00 

401.00 

875,00 

1000.00 

407.00 

870.00 

698.00 

450.00 

181.00 

369.00 

1973 

171.00 

300.00 

722.00 

327.00 

219.00 

275.00 

353.00 

450.00 

450.00 

162.00 

64.00 

145.00 

1974 

300 . 00 

324 . 00 

555.00 

855.00 

300.00 

420.00 

400.00 

577 . 00 

1038.00 

450.00 

263.00 

92.00 

1975 

51.00 

300.00 

518.00 

669.00 

300.00 

300.00 

279.00 

554.00 

502.00 

450.00 

307.00 

163.00 

1976 

300.00 

712.00 

1306.00 

746.00 

300.00 

244 .00 

400.00 

485.00 

450.00 

450.00 

323.00 

157.00 

1977 

153.00 

300.00 

300.00 

300.00 

300.00 

300.00 

400.00 

450.00 

439.00 

142.00 

141.00 

262.00 

AVE 

282.06 

384.00 

512.75 

540.06 

387 .50 

342.62 

384.81 

537.31 

540.62 

319.44 

191.00 

234.44 

C.V. 

0.3425 

0.3176 

0.5245 

0.3507 

0.4750 

0.5234 

0.1119 

0.2430 

0.3437 

0.3821 

0 . 5623 

0.5363 

UNITS  ARE  CUBIC  FEET  PER  SECOND 


Fig.  5.12.  Continued 
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DATE  -  90/06/18.  NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000  PROGRAM  -  QABSMN 

TIME  -  13.42.53.  MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977 

INSTREAM  FLOW  SHORTAGES 


YEAR 

OCT 

NOV 

DEC 

JAN 

FEB 

MAR 

APR 

MAY 

JUNE 

JULY 

AUG 

SEPT 

1962 

0.00 

0.00 

0.00 

0.00 

0.00 

57 .00 

0.00 

0.00 

0.00 

132.00 

169.00 

253.00 

1963 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

56.00 

203.00 

325.00 

301.00 

1964 

0.00 

0,00 

0.00 

0.00 

0.00 

0.00 

0,00 

0.00 

0.00 

0,00 

11.00 

45.00 

1965 

0.00 

0.00 

0.00 

0.00 

0.00 

0 . 00 

0.00 

0.00 

0.00 

228,00 

304 . 00 

207.00 

1966 

0.00 

0.00 

0.00 

0.00 

25 . 00 

0.00 

0.00 

0.00 

0.00 

26.00 

330.00 

372.00 

1967 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

116.00 

0.00 

0.00 

206.00 

379.00 

377.00 

1968 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

229.00 

212.00 

0.00 

1969 

0.00 

0.00 

0.00 

0.00 

99.00 

0.00 

0.00 

0.00 

0.00 

201.00 

360.00 

49.00 

1970 

0.00 

0.00 

0.00 

0.00 

0 . 00 

0.00 

0.00 

0.00 

0.00 

268.00 

360.00 

91.00 

1971 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

273.00 

242.00 

1972 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

269.00 

81.00 

1973 

129.00 

0.00 

0.00 

0.00 

81.00 

25.00 

47.00 

0.00 

0.00 

288.00 

386.00 

305.00 

1974 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

0.00 

187.00 

358.00 

1975 

249 .00 

0.00 

0.00 

0.00 

0.00 

0.00 

121.00 

0.00 

0.00 

0.00 

143.00 

287.00 

1976 

0.00 

0.00 

0.00 

0.00 

0.00 

56.00 

0.00 

0.00 

0.00 

0.00 

127.00 

293.00 

1977 

147 .00 

0.00 

0.00 

0.00 

0 . 00 

0.00 

0.00 

0.00 

11.00 

308.00 

309.00 

188.00 

AVE 

32.81 

0.00 

0.00 

0.00 

12.81 

8.62 

17  .75 

0.00 

4 . 19 

130.56 

259.00 

215.56 

C.V. 

2.2673 

0.0000 

0.0000 

0.0000 

2.4149 

2.2837 

2.3121 

0.0000 

3.3639 

0.9348 

0.4147 

0.5832 

UNITS  ARE  CUBIC  FEET  PER  SECOND 


ANNUAL  DIVERSION 


1962 

85530.06 

1963 

60015.78 

1964 

116855.64 

1965 

88309.98 

1966 

90042.48 

1967 

107357 . 58 

1968 

114206.41 

1969 

117113 .04 

1970 

76115.16 

1971 

120221.64 

1972 

148923 .73 

1973 

43189 .74 

1974 

1977 

143589.61 

49602.96 

1975 

103027.33 

1976 

98655.48 

AVERAGE  IS  97672. 

C.V.  IS  0.3110 


UNITS  ARE  ACRE -FEET 


DATE  -  90/06/18.  NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000  PROGRAM  -  QABSMN 

TIME  -  13.42.53.  MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977 

ANNUAL  DIVERSION  VERSUS  YEAR 

0  30000  60000  90000  120000  150000  180000  210000 

1962  - 

1963  - 

1964  - 

1965  - 

1966  - 

1967  - 

1968  - 

1969  - - 

1970  - 

1971  - 

1972  - 

1973  - 

1974  - 

1975  - 

1976  - 

1977  - - 

0  30000  60000  90000  120000  150000  180000  210000 


Fig.  5.12.  Continued, 
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ANNUAL  DIVERSION  SHORTAGE 


1962 

110291 

1963 

135806 

1964 

79461 

1965 

107512 

1966 

105779 

1967 

88464 

1968 

82110 

1969 

78708 

1970 

119706 

1971 

75600 

1972 

47393 

1973 

152632 

1974 

52232 

1975 

92794 

1976 

97661 

1977 

146219 

AVERAGE  IS 

98273. 

C.V.  IS 

0.3081 

UNITS  ARE  ACRE- 

•FEET 

ANNUAL  SHORTAGE 

AS  PERCENT 

OF  THE 

DESIRED 

DIVERSION 

1962 

56.32 

1963 

69.35 

1964 

40.58 

1965 

54.90 

1966 

54 . 02 

1967 

45.18 

1968 

41.93 

1969 

40.19 

1970 

61.13 

1971 

38.61 

1972 

24.20 

1973 

77.94 

1974 

26.67 

1975 

47.39 

1976 

49 . 87 

1977 

74.67 

5.12. 

Continued, 
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NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH 

MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977  (POST 


12142000 

1962 

1 

300.00 

300.00 

465.00 

615.00 

300.00 

243.00 

12142000 

1962 

2 

434.00 

450.00 

450.00 

318.00 

281.00 

197.00 

12142000 

1963 

1 

300.00 

471.00 

498.00 

300.00 

436.00 

300.00 

12142000 

1963 

2 

400.00 

450.00 

394.00 

247.00 

125.00 

149.00 

12142000 

1964 

1 

300.00 

501.00 

300.00 

418.00 

300.00 

300.00 

12142000 

1964 

2 

400.00 

546.00 

919.00 

450.00 

439.00 

405.00 

12142000 

1965 

1 

300.00 

318.00 

492.00 

670.00 

521.00 

300.00 

12142000 

1965 

2 

400.00 

450.00 

450.00 

222.00 

146.00 

243.00 

12142000 

1966 

1 

300.00 

300.00 

300.00 

300 . 00 

275.00 

300.00 

12142000 

1966 

2 

400.00 

498.00 

450.00 

424.00 

120.00 

78.00 

12142000 

1967 

1 

300.00 

355.00 

749.00 

804.00 

322.00 

300.00 

12142000 

1967 

2 

284.00 

450.00 

471.00 

244.00 

71.00 

73.00 

12142000 

1968 

1 

510.00 

300.00 

746.00 

603.00 

667.00 

300.00 

12142000 

1968 

2 

400.00 

450.00 

450.00 

221.00 

238.00 

450.00 

12142000 

1969 

1 

328.00 

486.00 

353.00 

482.00 

201.00 

300.00 

12142000 

1969 

2 

400.00 

713.00 

464.00 

249.00 

90.00 

401.00 

12142000 

1970 

1 

300.00 

300.00 

300.00 

463.00 

300.00 

300.00 

12142000 

1970 

2 

400.00 

450.00 

450.00 

182.00 

90.00 

359.00 

12142000 

1971 

1 

300.00 

339.00 

300.00 

688.00 

584.00 

300.00 

12142000 

1971 

2 

400.00 

754.00 

575.00 

450.00 

177.00 

208.00 

12142000 

1972 

1 

300.00 

538.00 

300.00 

401.00 

875.00 

1000 

12142000 

1972 

2 

407.00 

870.00 

698.00 

450 . 00 

181.00 

369.00 

12142000 

1973 

1 

171.00 

300.00 

722.00 

327 .00 

219.00 

275.00 

12142000 

1973 

2 

353.00 

450.00 

450.00 

162.00 

64.00 

145.00 

12142000 

1974 

1 

300.00 

324.00 

555.00 

855.00 

300.00 

420.00 

12142000 

1974 

2 

400.00 

577.00 

1038 

450.00 

263.00 

92.00 

12142000 

1975 

1 

51 . 00 

300.00 

518.00 

669.00 

300.00 

300.00 

12142000 

1975 

2 

279.00 

554.00 

502.00 

450 . 00 

307 . 00 

163.00 

.12142000 

1976 

1 

300.00 

712.00 

1306 

746.00 

300.00 

244.00 

12142000 

1976 

2 

400.00 

485.00 

450.00 

450.00 

323.00 

157.00 

12142000 

1977 

1 

153 . 00 

300.00 

300.00 

300 . 00 

300.00 

300.00 

12142000 

1977 

2 

400.00 

450.00 

439.00 

142.00 

141.00 

262.00 

Fig.  5.13.  Sample  output  (ZMONQ  file)  from  the  QABSMN  program. 
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Introduction 

Monthly  time  steps  are  used  in  most  instream  flow 
studies,  because  of  the  convenience  and  the  fact  that  pro¬ 
grams  have  not  been  written  to  use  shorter  time  steps.  Until 
recently,  the  vast  majority  of  applications  did  not  deal  with 
projects  requiring  a  daily  time  step.  Daily  values  of  stream- 
flow  will  likely  be  used  in  the  evaluation  of  small  hydro 
projects.  At  this  time,  the  only  program  available  that  uses 
daily  streamflow  data  directly  is  the  HABTD  program. 

The  HABTD  program  uses  daily  streamflows  and  the 
habitat  area-versus-streamflow  relation  (ZHAQF  file)  to 
develop  both  monthly  and  daily  values  of  habitats.  The 
monthly  values  are  developed  from  the  daily  values  of 
habitat. 

The  USGS’s  WATSTORE  data  base  contains  flow  val¬ 
ues  recorded  at  a  variety  of  frequencies.  Programs  exist 
within  the  WATSTORE  data  base  system  that  will  deter¬ 
mine  probability  of  exceedence  curves  for  flow  values  at 
those  frequencies.  The  same  probability  of  exceedence 
concepts  have  been  applied  to  the  amount  of  weighted 
usable  habitat  area  available  in  the  study  reach  because 
habitat  area  is  the  important  variable  to  any  study  species. 

The  daily  habitat  exceedence  program  (DQDUR)  uses 
information  gained  from  a  daily  flow  duration  analysis  and 
the  habitat  area-versus-flow  relation  to  define  a  daily 
habitat  probability  exceedence  curve.  Each  exceedence 


curve  is  applicable  only  for  a  particular  life  stage  of  species 
at  a  given  study  site. 

The  first  step  in  obtaining  the  daily  habitat  exceedence 
is  to  run  the  flow  duration  analysis  program  associated 
with  the  USGS’s  data  base.  The  TSLIB  program  DURTBL 
is  used  to  generate  a  “Daily  Streamflow  Values  Dura¬ 
tion  Table”  request  file  to  retrieve  the  data  from  the 
WATSTORE  data  base. 

The  duration  analysis  file  obtained  from  WATSTORE 
contains  a  ranking  and  the  probability  of  exceedence  for 
flows  occurring  during  a  given  day  of  a  particular  month. 
This  extremely  large  file  can  be  reduced  by  the  SELDUR 
program  into  a  file  that  contains  just  the  important  flow 
duration  table.  Either  the  reduced  file  or  the  original 
WATSTORE  file  can  be  used  as  input  to  the  DQDUR 
program,  which  has  options  to  calculate  class  distribution, 
habitat  exceedence  values  and  graphs,  and  (or)  duration 
percentages.  (Refer  to  Chapter  2  for  DURTBL  and 
SELDUR  program  documentation.) 


Note:  Highly  variable  daily  flows  may  invalidate 
the  use  of  a  “standard”  habitat  area-versus- 
streamflow  function.  You  are  responsible  for 
making  sure  that  the  calculated  habitat  values 
are  biologically  relevant.  Using  PHABSIM’s 
HABEF  program  may  be  a  better  approach  un¬ 
der  some  circumstances. 
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Daily  Habitat  Time  Series  Generation 


Program  BatdVProcedurc 
Nan^  Filename  Rmctioii 

DQDUR  RDQDUR  Daily  habitat 

I«iobability 

exceedence 

generation 


HABTD  RHABTD  Daily  habitat 

time  series 
get^ration 


_ Program  Desaiption _ 

Processes  a  WATSTORE  duration  analysis  file  with  these  options: 

0  =  class  distributiem  statistics, 

1  =  habitat  exceedence  values  and  graphs  and  class  distribution 

statistics, 

2  =  duration  percentages,  or 

3  =  all  three. 

RDQDUR,  WATDUR,  ZOUT,  ZHAQF,  ZCL  ASS,  ZEXPLT, 
ZMONTH,  ZVAR,  ZREDUR 

WATDUR  =  WATSTORE  duration  analysis  file.  Can  be  directly 
from  WATSTORE  (generated  by  submitting  the  re¬ 
quest  job  created  by  the  DURTBL  program)  or  the  re¬ 
duced  file  created  by  the  SELDUR  program  (input). 

ZOUT  =  File  containing  a  list  of  headings  from  the  duration  analy¬ 
sis  file  (output). 

ZHAQF  =  Habitat-versus-streamflow  file.  Only  needed  if  Options  1 
or  3  are  selected  (input).  If  not  needed,  enter  ZZZ  for 
this  file. 

ZCL  ASS  =  Class  distribution  statistics,  created  by  Options  0, 1,  and 
3  (output). 

ZEXPLT  *  File  containing  exceedence  plots,  created  by  Options  1 
and  3  (output). 

ZMONTH  *=  File  containing  monthly  exceedence  statistics,  created 
by  Options  1  and  3  (output). 

ZVAR  =  File  of  percentage  of  exceeded  flows  and  variation  ratios, 
created  by  Options  2  and  3  (output). 

ZREDUR  =  Reduced  WATSTORE  duration  analysis  file  (output). 

Calculates  the  time  series  of  daily  habitat  values  and  converts  these  to 
monthly  habitat  time  series  using  user-supplied  criteria. 

RHABTD,  ZHAQF,  ZDQ,  ZMTS,  ZOUT,  DAYFL 

ZHAQF  =  Habitat-versus-flow  file  (input). 

ZDQ  =  Daily  streamflow  file  in  WATSTORE  format  (must  have 
been  run  through  DQFY  to  strip  incomplete  years  and  ex¬ 
cess  title  lines  (input). 

ZMTS  =  Monthly  habitat  time  series  file  in  NWDC  format,  one 
logical  record  per  life  stage  (output). 

ZOUT  =  HABTD  results  (output). 

DAYFL  =  File  of  daily  habitat  values  in  either  report  or  Lotus  1-2-3 
format.  Created  when  daily  habitat  values  are  requested 
(output). 
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Introduction 

The  DQDUR  program  processes  a  WATSTORE  dura¬ 
tion  analysis  file  with  several  options.  The  WATSTORE 
duration  analysis  file  contains  a  ranking  and  the  prob¬ 
ability  of  exceedence  for  flows  occurring  on  a  given  day 
of  a  particular  month.  The  duration  analysis  file  used 
as  input  to  the  DQDUR  program  can  be  directly  from 
WATSTORE  (generated  by  submitting  the  request  job 
created  by  the  DURTBL  program)  or  the  reduced  file 
created  by  the  SELDUR  program.  Chapter  2  contains 
documentation  for  the  DURTBL  and  SELDUR  programs. 

In  other  words,  DQDUR  can  produce  a  daily  habitat 
duration  table  from  a  daily  flow  duration  table  without 
directly  computing  the  habitat  value  for  every  day — it 
samples  100  flows  from  the  flow  duration  table  and 
thereby  can  allow  you  to  avoid  downloading  and  process¬ 
ing  a  master  data  file. 

Running  DQDUR 

RDQDUR,  WATDUR,  ZOUT,  ZHAQF,  ZCLASS, 

ZEXPLT,  ZMONTH,  ZVAR,  ZREDUR 

WATDUR  *  WATSTORE  duration  analysis  file.  Can 
be  directly  from  WATSTORE  (generated 
by  submitting  the  request  job  created  by 
the  DURTBL  program)  or  the  reduced 
file  created  by  the  SELDUR  program 
(input). 

ZOUT  =  File  containing  a  list  of  headings  from 
the  duration  analysis  file  (output). 

ZHAQF  *  Habitat-versus-streamflow  file.  Only 
needed  if  options  1  or  3  are  selected 
(input).  If  not  needed,  enter  ZZZ  for  this 
file. 

ZCLASS  *  Class  distribution  statistics,  created  by 
options  0, 1,  and  3  (output). 

ZEXPLT  =  File  containing  exceedence  plots,  cre¬ 
ated  by  options  1  and  3  (output). 

ZMONTH  =  File  containing  monthly  exceedence  sta¬ 
tistics,  created  by  options  1  and  3  (out¬ 
put). 

ZVAR  “  File  of  percentage  exceeded  flows  and 
variation  ratios,  created  by  options  2  and  3 
(output). 


ZREDUR  ■  Reduced  WATSTORE  duration  analysis 
file.  Created  if  WATDUR  was  directly 
from  WATSTORE  (output). 

DAIty  HjOW  pimATXON  «OM,YSI$ 

PROCESSINQ  WATSTORE  FILE,  THIS  MAY  TAKE  A  WHILE 
EWTilR  0  FOR  CLASS  STATISTICS 

1  FOR  EXCEEDENCE  PLOTS  AND  CLASS  StATISTtCS 
X  FOR  DORATION  PERCmACES 
S  FOR  ALL  THREE 


Description  of  DQDUR  program  options: 

0  -  Class  distribution  statistics — creates  a  data  file  that 
contains  the  classes,  flow  values,  and  probability  of 
exceedence  for  each  flow  for  each  month. 

1  =  Habitat  exceedence  values  and  graphs,  plus  class 

distribution  statistics.  This  option  takes  the  prob¬ 
ability  of  low  exceedence  curve  and  determines  the 
flows  corresponding  to  all  exceedence  percentages 
occurring  at  one  percent  intervals  for  the  entire 
range  defined  on  a  curve.  It  then  interpolates  either 
linearly  or  by  polynomial  representatives  for  the 
weighted  usable  area  (WUA)  values  from  the  flows. 
Polynomial  interpolation  is  applicable  when  the 
data  can  be  fit  easily  by  a  third  order  equation; 
otherwise,  linear  interpolation  should  be  used.  The 
WUA  values  are  then  ranked  in  ascending  order, 
and  the  probability  of  exceedence  is  determined  for 
a  given  habitat  value  from  its  ranking  relative  to  the 
total  range  of  habitat  values.  Thus,  the  habitat  prob¬ 
ability  of  the  exceedence  curve  is  determined  based 
on  the  probability  of  exceedence  for  flows  occur¬ 
ring  on  a  daily  basis  during  a  particular  month.  This 
curve,  however,  is  only  indirectly  related  to  the  flow 
exceedence  curve.  Therefore,  there  is  not  a  one-to- 
one  correspondence  between  the  two  curves. 

2  =  Duration  percentages — ^writes  a  file  containing  the 

flow  exceedence  curve  information  determined  in 
the  duration  analysis. 

3  =  Does  all  three  analyses. 

If  option  1  or  3  is  selected,  the  following  prompts  will 
appear: 

WATSTORE  FILEi 

ENTER  X  TO  USB  POLYNOMIAL  FUNCTtON  FOR  INTERPOLATI<»I 
_ 0  TO  USE  LINEAR  INTERPOLATION 


This  prompt  will  be  asked  for  both  the  WATSTORE 
duration  analysis  file  and  the  habitat-versus-streamflow 
file  used  as  input  to  DQDUR.  Polynomial  interpolation  is 
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applicable  when  the  data  can  be  fit  easily  by  a  third  order 
equation;  otherwise,  linear  interpolation  should  be  used.  If 
option  1  is  selected,  the  program  will  issue  a  warning 
because  it  could  give  negative  or  irrational  results  for 
nonlinear  extrapolation.  Do  not  use  this  option  unless  you 
are  prepared  to  handle  this. 

gTATTOKt  WOMBERS  OK  EftJRATXm  ANALYSIS  FILE? 


The  station  numbers  are  listed. 

■mtm  liXMBisR  statioits  to  dupatiw 

Figures  6. 1-6.5  contain  sample  outputs  from  the 
DQDUR  program — a  portion  of  sample  output  is  included 
from  each  of  the  files  created. 


1 

JANUARY 

DURATION  PLOT  OF  DAILY  DATA  FOR 
(YEARS  1930  *  1989) 

STATION  ID  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

DRAINAGE  AREA  «  64.00  SQ.  MI. 

2 

FEBRUARY 

DURATION  PLOT  OF  DAILY  DATA  FOR 
(YEARS  1930  -  1990) 

STATION  ID  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

DRAINAGE  AREA  »  64.00  SQ.  MI. 

Fig.  6.1.  Sample  output  (ZOUT)  from  the  DQDUR  program.  This  file  contains  a  list  of  headings  from  the  duration  analysis  file. 


STATION  ID  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

DURATION  PLOT  OP  DAILY  DATA  FOR  (YEARS  1930  -  1989) 

DRAINAGE  AREA  *  64.00  SQ.  MI. 


CLASS 

STATION  ID 

FLOW 

PERCENT 

EXCEEDENCE  PER  MONTH 

0 

12142000 

0.0 

100.00 

100.00 

100.00 

100.00 

100.00 

100.00 

12142000 

100.00 

100.00 

100.00 

100.00 

100.00 

100.00 

1 

12142000 

33.0 

100.00 

100.00 

100,00 

100.00 

100.00 

100.00 

12142000 

100 . 00 

100.00 

100.00 

100.00 

100.00 

100.00 

2 

12142000 

39.0 

100.00 

100.00 

100,00 

100.00 

100.00 

100.00 

12142000 

100.00 

99.21 

98.37 

98.55 

99.66 

100.00 

3 

12142000 

46.0 

100.00 

100.00 

100.00 

100.00 

100.00 

100.00 

12142000 

100.00 

95.39 

95.65 

96.58 

99.32 

100.00 

4 

12142000 

54.0 

100.00 

100.00 

100.00 

100.00 

100.00 

100.00 

12142000 

99.28 

89.34 

90.34 

94.14 

99 .32 

100.00 

5 

12142000 

64.0 

100.00 

100.00 

100.00 

100.00 

100 . 00 

100.00 

12142000 

97  .76 

78.14 

83.33 

91,51 

99.18 

100.00 

Fig.  62,  Sample  output  (ZCLASS)  from  the  DQDUR  program.  This  file  contains  class  distribution  statistics. 
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STATION  NUMBER:  12142000. 
100.00  ============== 

#  1 

#  1 

#  1 

# 

90.000  # - 

# 

# 

# 

# 

80.000  # - 

# 

# 

# 

# 

70.000  # - 

# 

# 

# 

# 

60.000  # - 

# 

# 

%  EXCEED  # 

# 

50.000  # - 

# 

# 

# 

# 

40.000  # - 

# 

I 

# 

# 

30.000  # - 

# 

# 

# 

# 

20.000  # - 

# 

# 

# 

# 

10.000  # - 

# 

#  1 

#  1 

#  1 

O.OOOOOE-01  =========-====^ 

O.OOOOOE-01 

2000.0 


1 

1 

1 


1 

1 

1 


1*1  1  1 

1*1  1  1 

1*1  1  1 

★ 

* 

* 

* 

*  * 

*  * 

■** 

*  * 

** 

** 

*  * 


1111 

1111 

1111 


PROGRAM  -  DQDUR 


4000.0 

6000.0 


8000.0 

10000. 


12000. 

14000. 


16000.  20000. 
18000. 


WUA 

SPECIES:  RAINBOW  TROUT  L.  STAGE:  FRY  MONTH:  JAN 

SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 


Fig.  63.  Sample  output  (ZEXPLT^  from  the  DQDUR  program.  This  file  contains  exceedence  plots  for  each  month,  for  each  spe¬ 
cies  and  life  stage  in  the  21HAQF  file. 
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WA 

12142000 


SNOQUALMIE  RIVER 
NEAR  SNOQUALMIE  FALLS 
STATION  NUMBER: 
RAINBOW  TROUT 

MONTH;  JAN 
HABITAT  AREA 
19789.58 
19788.79 
19788.01 
19787.22 
19786.43 
19785.64 
19784 . 85 
19784.06 
19783.28 
19782.49 
19781.66 
19780.77 
19771.31 
19753.96 
19711.35 


FRY 

PERCENT  EXCEEDENCE 
0.99 
1.98 
2.97 
3.96 
4.95 
5.94 
6.93 
7.92 
8.91 
9.90 
10.89 
11.88 
12.87 
13.86 
14.85 


Fig.  6.4.  Sample  output  (ZMONTH)  from  the  DQDUR  program.  This  very  large  file  contains  monthly  exceedence  statistics  for 
each  species  and  hfe  stage  in  the  ZHAQF  file. 


STATION  ID  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS, 


ANALYSIS 

FOR  PERIOD 

OF  RECORD 

(YEARS 

1930  - 

1989) 

MONTH 

Q95 

Q90 

Q7  5 

Q70 

Q50 

Q25 

QIO 

VR 

******* 

******* 

*******  * 

******  * 

****** 

******* 

******* 

******* 

***  **i 

JANUARY 

140 . 0 

168 . 0 

230.0 

251.0 

371.0 

690.0 

1330.0 

2.21 

FEBRUARY 

138.0 

158.0 

223.0 

243.0 

333.0 

548.0 

984.0 

2.11 

MARCH 

176 . 0 

197 .0 

252 . 0 

269.0 

356.0 

542.0 

860.0 

1 . 81 

APRIL 

249.0 

278.0 

354 . 0 

381.0 

488.0 

697.0 

972.0 

1.76 

MAY 

325.0 

370.0 

476.0 

507 .0 

651.0 

894.0 

1210.0 

1.76 

JUNE 

206.0 

274 . 0 

390.0 

422.0 

568.0 

812.0 

1130.0 

2.07 

JULY 

78.3 

95.2 

140.0 

157 .0 

235.0 

388.0 

620.0 

2.47 

AUGUST 

46 .5 

53 . 1 

67 . 1 

72 . 1 

96.8 

154.0 

256 .0 

1.82 

SEPTEMBER 

47 . 0 

54.5 

75.7 

82.4 

118.0 

235.0 

474.0 

2.17 

OCTOBER 

51.2 

69.5 

111.0 

126 .0 

205.0 

435.0 

821.0 

2.95 

NOVEMBER 

115.0 

162.0 

254.0 

285.0 

435.0 

748.0 

1350.0 

2.69 

DECEMBER 

171.0 

201.0 

281.0 

308.0 

450.0 

812.0 

1550.0 

2.24 

DRAINAGE  AREA  =  64.00  SQ.  MI. 

VR  =  VARIATION  RATIO  (Q50/Q90) 


WA. 


Fig.  6.5.  Sample  output  (ZVAR)  from  the  DQDUR  program.  This  file  contains  the  percentage  for  exceeded  flows  and  variation 
ratios. 
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Introduction 

The  HABTD  program  calculates  the  time  series  of  daily 
habitat  values  and  converts  these  to  monthly  habitat  time 
series  from  user-supplied  criteria. 


Running  HABTD 

RHABTD,  ZHAQF,  ZDQ,  ZMTS,  ZOUT,  DAYFL 

ZHAQF  =  Habitat  area-versus-flow  file  (input). 

ZDQ  =  Daily  streamflow  file  in  WATSTORE 
format  (input).  (File  must  have  been  run 
through  the  DQFY  program  to  strip  in¬ 
complete  years  and  excess  title  lines.) 

ZMTS  =  Monthly  habitat  data  in  NWDC  format, 
one  logical  record  per  life  stage  (output). 

ZOUT  =  HABTD  results  (output). 

DAYFL  *  File  of  daily  habitat  values  in  either  re¬ 
port  or  Lotus  1-2-3  format.  Created 
when  daily  habitat  values  are  requested 
(output). 

i'BirrBR  RECORD'  NAME|  <S:  .CHAR)  ;■  -^V:  ' 


On  the  ZMTS  output  file,  the  data  for  each  species  and 
life  stage  is  written  as  a  separate  section  terminated  by 
“#EOR”  and  is  preceded  by  a  header-line  containing  a 
user-designated  label  and  a  sequential  numbering  system. 

For  example,  if  CLASS  is  entered  here  as  the  record 
name,  the  very  top  line  on  the  ZMTS  file  will  contain  the 
letters  CLASSAl .  Following  this  line  will  be  two  title  lines 
and  then  the  habitat  data  for  the  first  species,  first  life  stage. 
Next  there  will  be  a  line  containing  the  letters  CLASSA2, 
followed  by  two  title  lines  and  the  data  for  the  first  species, 
second  life  stage.  Following  all  life  stages  of  the  first 
species,  the  line  will  contain  CLASSBl  for  the  second 
species,  first  life  stage,  and  so  forth.  In  other  words,  each 
species  will  begin  a  new  letter  (A-D)  and  each  life  stage 
will  begin  a  new  number  (1-5). 

■  ENTER: LINEAR  i^r^ERP01ATIQK,  2  FOR  FmLlKEAR  •=!:  :  ••  ■  .  . 


If  2  is  entered  for  nonlinear,  the  following  prompt  will 
appear. 

:  enter  ,:,::41.::F0R  •  LINEAR  TAILS,  2  FOR  WONEINBAR _ 


Flow  values  in  the  flow-versus-time  series  that  are 
smaller  than  lowest  flows  or  greater  than  highest  flows  in 
the  flow-versus-habitat  relation  are  considered  "tail” 
flows.  Habitat  values  for  these  tail  flows  must  be  extrapo¬ 
lated.  Indicate  whether  the  extrapolation  should  be  linear 
or  nonlinear.  The  program  will  l  a  warning  because  it 
could  give  negative  or  wildly  irrational  results  for  nonlin¬ 
ear  extrapolation.  Do  not  use  this  option  unless  you  are 
prepared  to  handle  this. 

JBNTER  %  FOR  AVERAGE  HABITAT  AS  MOKTHLY  HABITAT 

2  FOR  MINIMUM  HABITAT  AS  MOITTHLY  HABITAT 

3  FOR  MINIMUM  OF  JN-OaYS  AS  HABITAT 

; _ 4  FOR  MEDIAN  HABITAT  AS  MONTHLY  HABITAT 


Description  of  options  to  calculate  monthly  habitats: 

1  =  The  monthly  habitat  value  is  the  average  of  the  daily 

habitats  for  the  month. 

2  =  The  monthly  habitat  value  is  the  minimum  of  the 

daily  habitats  for  the  month. 

3  “  The  monthly  habitat  value  is  the  minimum  /i-day 

average  habitat  value  for  the  month. 


The  habitat  value  calculated  with  this  is  determined  by 


HA(y)  = 


mm 


rt+i 


£HAD(y.i),£HAD(y.«), 


i=  1 


i  =  2 


n+2  m 

£HADO;i)....,£HAD(y./) 

1  =  3  i  =  OT  “  /I 


where 


j  =  the  index  to  the  month, 
i  =  the  day, 

/n  =  the  number  of  days  in  month  j, 

n  =  the  number  of  days  specified  for  an  av¬ 
erage, 

HAD  =  the  daily  habitat,  and 
HA  =  the  monthly  habitat. 


Use  of  a  minimum  n-day  average  makes  the  assumption 
that  the  fish  can  be  crowded  for  short  periods  and  cannot 
fill  all  the  habitat  during  periods  of  excess  habitat  when 
those  periods  are  relatively  short. 


4  -  The  monthly  habitat  value  is  the  median  habitat 
value  for  the  month. 
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If  3  is  selected,  you  will  be  prompted  to  enter 

HCW  PAYS: _ _ _ 

Enter  the  number  of  days  needed  to  determine  the  mini¬ 
mum  average.  The  program  will  average  the  flow  for  all  n 
consecutive  days  for  the  month  and  use  the  minimum 
average  for  the  monthly  habitat  value. 


.tNTjER 0  .  JlQ  PRIWT  Ot  DAILY  VALUES . 

X  POR  RBBQRT.  FORMAT  OUTPUT  OJ?  DAILY  VALUES 
_ X  FOR  LOTOS  PILE  FORMAT  OOTPOT  OF  DAILY  VALUES 


The  program  will  begin  computation.  This  computation 
might  take  anywhere  from  a  few  seconds  to  15  min  de¬ 
pending  on  the  speed  of  your  computer. 

The  two  file  formats  available  for  the  daily  habitat  values 
files  (DAYFL)  are  shown  in  Fig.  6.6.  Figure  6.7  contains 
sample  output  from  the  ZOUT  file.  Figure  6.8  contains  the 
monthly  habitat  time  series  (ZMTS)  file  from  HABTD. 


Sample  Dally  Habitat  Values  File  (DAYFL)  In  Report  Format: 


89/04/20. 

13.52.35. 


SNOQUALMIE  RIVER 


NEAR 

SNOQUALMIE 

FALLS,  WA 

SPECIES 

:  RAINBOW  TROUT 

LIFE  STAGE: 

FRY 

Date 

Daily  Habitat 

MONTH: 

10-  YEAR: 

70 

1  - 

18044.80 

2 

-  17418.40 

3  - 

16792.00 

4 

-  16513.60 

5 

-  15725.80 

6  - 

18601.20 

7 

-  19784.00 

8  * 

19789.00 

9 

7062.20 

10 

9419.80 

11  - 

15270.80 

12 

-  14542.80 

13  - 

17627 .60 

14 

-  19270.80 

15 

-  19780.40 

16  - 

19786 .40 

17 

-  19753.60 

18  - 

19789 .00 

19 

-  18855.60 

20 

-  17627.60 

21  - 

15052.40 

22 

'  15052.40 

23  - 

9963.00 

24 

9672.00 

25 

-  15489.20 

26  - 

18474 . 00 

27 

-  19471.80 

28  - 

19781.00 

29 

-  19785.60 

30 

-  19788.20 

31  -  19717.20 


Sample  Daily  Habitat  Valuee  File  (DAYFL)  in  LOTUS  1-2-3  Format; 


89/04/20. 

13.56.24. 


SNOQUALMIE  RIVER 
NEAR  SNOQUALMIE  FALLS,  WA 
SPECIES:  RAINBOW  TROUT 

Daily  Habitat 


"  Date 
“10/  1/70" 
“10/  2/70" 
“10/  3/70" 
“10/  4/70" 
“10/  5/70" 
“10/  6/70" 
“10/  7/70" 
“10/  8/70" 
“10/  9/70" 
“10/10/70" 


18044.80 
17418.40 
16792.00 
16513.60 

15725.80 
18601.20 
19784.00 
19789.00 

7062.20 

9419.80 


LIFE  STAGE:  FRY 


Fig.  6.6.  Sample  daily  habitat  values  file  (DAYFL)  formats  from  the  HABTD  program. 
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89/02/09  . 
15.37 .35. 


89/02/09 . 
15.37 .35. 


SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

HABITAT  VS.  STREAMPLOW  FILE  - 
RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10,00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

9410.00 

350.00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270.00 

8880.00 

1500.00 

6940,00 

8490.00 

7620.00 

2000.00 

7210,00 

8630.00 

7810.00 

4000,00 

6660,00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 


HABITAT 

FACTORS 

FOR  RAINBOW 

TROUT 

DISCHARGE 

AREA 

A 

B 

c 

D 

10.00 

20570.00 

0.00 

0.00 

--57 . 44 

21144.45 

100.00 

15400.00 

0.00 

0.00 

69.60 

8440 . 00 

150.00 

18880.00 

0.00 

0.00 

18.20 

16150.00 

200.00 

19790.00 

0.00 

0.00 

"0.20 

19830.00 

250.00 

19780.00 

0.00 

0.00 

"13.40 

23130.00 

300.00 

19110.00 

0.00 

0.00 

"21.20 

25470,00 

350.00 

18050.00 

0.00 

0.00 

"35.20 

30370 . 00 

400.00 

16290.00 

0.00 

0.00 

"18.20 

23570.00 

500.00 

14470.00 

0.00 

0.00 

"34.40 

31670.00 

600.00 

11030.00 

0.00 

0.00 

-•9  .70 

16850 . 00 

800.00 

9090.00 

0.00 

0.00 

"6. 40 

15810.00 

1000.00 

7410.00 

0.00 

0.00 

"0.94 

8350.00 

1500.00 

6940.00 

0.00 

0.00 

0.54 

6130.00 

2000.00 

7210.00 

0.00 

0.00 

"0.28 

7760.00 

4000.00 

6660.00 

0.00 

0.00 

"0.46 

8500.00 

6000.00 

5740.00 

ha  =  A*Q**3  +  B*Q**2  +  C*Q  +  D 


PROGRAM  -  HABTD 
PAGE  1 


PROGRAM  -  HABTD 
PAGE  2 

FRY 


The  following  warning  appeared  on  the  screen  when  the  HABTD  program  was  running: 

“Warning — ^Daily  streamflow  data  is  out  of  boxmds  of  habitat/flow  relationship.  Invalid  results  may  occur. 
See  ZOUT  for  more  detail.” 


WARNING  -  DISCHARGE 
WARNING  -  DISCHARGE 
WARNING  -  DISCHARGE 
WARNING  -  DISCHARGE 
WARNING  *  DISCHARGE 


7400.000  GREATER 
6900.000  GREATER 
6660.000  GREATER 
6650.000  GREATER 
7280.000  GREATER 


THAN  HIGHEST  FLOW  IN  Q 
THAN  HIGHEST  FLOW  IN  Q 
THAN  HIGHEST  FLOW  IN  Q 
THAN  HIGHEST  FLOW  IN  Q 
THAN  HIGHEST  FLOW  IN  Q 


-  HA  RELATIONSHIP 
■  HA  RELATIONSHIP 

-  HA  RELATIONSHIP 

-  HA  RELATIONSHIP 

-  HA  RELATIONSHIP 


Fig.  6.7.  Sample  output  (ZOUT  file)  from  the  HABTD  program. 
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MEAN  MONTHLY  STREAMFLOW  DATA  - 

H  12142000  4736541214244005353033SW17110010  64.00  1130.00 

N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

MONTH 


YEAR 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

1971 

363.84 

588.87 

480.13 

937.68 

834.11 

396.55 

444.27 

1053.77 

875.37 

717 .16 

176.84 

208.37 

1972 

373.65 

788.20 

536  .77 

651.45 

1125.00 

1250.29 

682.43 

1169.74 

997  .77 

732.74 

181.10 

369.23 

1973 

170.52 

391.93 

971.87 

576.71 

218.54 

275.23 

352.63 

523.23 

493.00 

161.65 

63.58 

144.83 

1974 

430.87 

574.30 

805.23 

1105.45 

452.75 

669.68 

620.30 

877.35 

1338.43 

724.52 

262.65 

92.27 

1975 

50.94 

527 .60 

768.35 

919.35 

438.61 

428.00 

279.20 

853.68 

801.97 

564.06 

306,58 

162.63 

1976 

518.32 

961.57 

1556.03 

996.00 

342.69 

243.87 

479.87 

785.35 

645.20 

491.03 

322.84 

156.50 

1977 

153.39 

387 .73 

485.19 

500.16 

324.82 

332.26 

604.90 

535.10 

438.83 

141.94 

140.94 

261.73 

1978 

270.32 

969.07 

1205.23 

450.00 

365.46 

382.90 

388.20 

524.03 

397.57 

179 . 16 

189.90 

452.27 

1979 

151.10 

545.90 

464.52 

222.06 

581.82 

653.84 

515.57 

713.87 

460.93 

285.68 

72.52 

87.03 

1980 

194.87 

134.73 

1202.06 

325.65 

549.41 

376.00 

655.50 

452.23 

443.30 

226.26 

159.10 

432.97 

1981 

138.84 

879  .90 

1139.23 

244.26 

911.86 

245.87 

874.47 

566.97 

727.80 

220.90 

94.29 

212.97 

1982 

526.13 

380.47 

580.77 

822.19 

1294.68 

569  .74 

420.17 

697.00 

719.33 

374.68 

156.42 

273 .37 

HABITAT  TIME  SERIES  - 

RAINBOW  TROUT 
FRY 

MONTH 


YEAR 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

1 

1971 

16894 . 

14585. 

16598. 

12035. 

12444  . 

16865. 

15501. 

8019  . 

9006  , 

10400. 

17841. 

17452  . 

1972 

16294 . 

12313  . 

15399. 

15073. 

11639  . 

9344  . 

12353  . 

8409  . 

8325. 

12460. 

18655. 

15320. 

1973 

17872  . 

16138. 

13202. 

16229. 

18966. 

19033 . 

17418. 

14164 . 

14600. 

17977 . 

17492. 

17434  . 

1974 

15879 . 

14592. 

10831. 

12325. 

15749  . 

13271. 

11672. 

10222. 

7804  . 

10121. 

18474 . 

17152. 

1975 

18218  . 

14871. 

13755, 

13843. 

15871. 

16687 . 

18945. 

9960. 

9786  . 

14472. 

17169 . 

17229  . 

1976 

14953 . 

11717  . 

10860. 

11302. 

17715. 

18909. 

14929  . 

10597 . 

12494  . 

14811. 

18238. 

17802. 

1977 

16681 . 

16269  . 

16253 . 

16897  . 

17474  . 

17980. 

13293  . 

13607 . 

15855. 

17  876  . 

17495. 

17694  . 

1978 

17725. 

11887  . 

12576. 

16373. 

17150, 

16754 . 

16876  . 

13973 . 

16614 . 

18622  . 

17352. 

16031. 

1979 

17986 . 

15351 . 

16165. 

18184  . 

14082. 

14780. 

14224. 

10697 . 

15320. 

17188. 

16979 . 

17094  . 

1980 

17148 . 

17548  . 

11464 . 

17626  . 

14897  . 

17149 . 

12386  . 

15392 . 

15625. 

18762  . 

16667  . 

16649  . 

1981 

17381. 

12436  . 

10624 . 

18758. 

13237  . 

19253 . 

12931 . 

13102. 

11700. 

19105. 

16670. 

16783  . 

1982 

15170. 

16546  . 

14496  . 

14170. 

12447  . 

15264  . 

16186  . 

10901. 

10577  . 

16605. 

17271, 

16979  . 

AVERAGE  OF  DAILY  HABITAT  VALUES  USED  AS  MONTHLY  VALUE 


Fig.  6.7.  Continued, 


HABTD  Program 
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CLASSAl 

SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


12142000 

1971 

1 

16894 

14585 

16  59  8 

12035 

12444 

16865 

12142000 

1971 

2 

15501 

8019 

9006 

10400 

17841 

17452 

12142000 

1972 

1 

16294 

12313 

15399 

15073 

11639 

9344 

12142000 

1972 

2 

12353 

8409 

8325 

12460 

18655 

15320 

12142000 

1973 

1 

17  872 

16138 

13202 

16229 

18966 

19033 

12142000 

1973 

2 

17418 

14164 

14600 

17977 

17492 

17434 

12142000 

1974 

1 

15879 

14592 

10831 

12325 

15749 

13271 

12142000 

1974 

2 

11672 

10222 

7804 

10121 

18474 

17152 

12142000 

1975 

1 

18218 

14871 

13755 

13843 

15871 

16687 

12142000 

1975 

2 

18945 

9960 

9786 

14472 

17169 

17229 

12142000 

1976 

1 

14953 

11717 

10860 

11302 

17715 

18909 

12142000 

1976 

2 

14929 

10597 

12494 

14811 

18238 

17802 

12142000 

1977 

1 

16681 

16269 

16253 

16897 

17474 

17980 

12142000 

1977 

2 

13293 

13607 

15855 

17876 

17495 

17694 

12142000 

1978 

1 

17725 

11887 

12576 

16373 

17150 

16754 

12142000 

1978 

2 

16876 

13973 

16614 

18622 

17352 

16031 

12142000 

1979 

1 

17986 

15351 

16165 

18184 

14082 

14780 

12142000 

1979 

2 

14224 

10697 

15320 

17188 

16979 

17094 

12142000 

1980 

1 

17148 

17548 

11464 

17626 

14897 

17149 

12142000 

1980 

2 

12386 

15392 

15625 

18762 

16667 

16649 

12142000 

1981 

1 

17381 

12436 

10624 

18758 

13237 

19253 

12142000 

1981 

2 

12931 

13102 

11700 

19105 

16670 

16783 

12142000 

1982 

1 

15170 

16546 

14496 

14170 

12447 

15264 

12142000 

#EOR 

CLASSA2 

1982 

2 

16186 

10901 

10577 

16605 

17271 

16979 

SNOQUALMIE 

RIVER 

JUVENIL 

RAINBOW 

TROUT 

12142000 

1971 

1 

11761 

12041 

11761 

10643 

12995 

12959 

12142000 

1971 

2 

14707 

10262 

11720 

13246 

8165 

8814 

12142000 

1972 

1 

10550 

14077 

13141 

13486 

11449 

10875 

12142000 

1972 

2 

13863 

10354 

10751 

13459 

8464 

8327 

12142000 

1973 

1 

7892 

11082 

9920 

12329 

9651 

11976 

12142000 

1973 

2 

13516 

14539 

14240 

7768 

6166 

8132 

12142000 

1974 

1 

10915 

12589 

12946 

9843 

13967 

13730 

12142000 

1974 

2 

14539 

12610 

9849 

13166 

10751 

6025 

12142000 

1975 

1 

6651 

11219 

13339 

12126 

13999 

12949 

12142000 

1975 

2 

12067 

12121 

12469 

12077 

9752 

7595 

12142000 

1976 

1 

11071 

12068 

11931 

13269 

12954 

107  07 

12142000 

1976 

2 

14130 

12928 

13853 

13878 

12009 

7333 

12142000 

1977 

1 

7163 

10057 

12426 

10209 

11580 

13281 

12142000 

1977 

2 

13429 

14860 

12536 

6922 

8272 

10577 

12142000 

1978 

1 

9678 

11459 

11517 

12766 

12983 

12148 

12142000 

197  8 

2 

14068 

14337 

14229 

8388 

8384 

13679 

12142000 

1979 

1 

7193 

117  03 

12911 

8654 

11750 

13549 

12142000 

1979 

2 

14021 

13247 

14295 

10639 

5824 

5954 

12142000 

1980 

1 

8611 

6556 

11472 

11455 

12392 

14310 

12142000 

1980 

2 

12998 

14646 

14608 

10139 

7218 

10598 

12142000 

1981 

1 

6585 

12299 

11725 

10522 

9666 

10815 

12142000 

1981 

2 

13315 

14996 

1307  0 

10018 

5650 

8625 

12142000 

1982 

1 

11246 

12809 

13391 

10829 

12272 

13275 

12142000 

1982 

2 

13115 

13512 

13179 

13187 

7071 

8493 

#EOR 


Fig.  6,8.  Sample  monthly  habitat  time  series  (ZMTS)  file  from  the  HABTD  program.  Sample  incomplete;  terminated  for  brevity. 
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Chapter  7. 

Generation  of  the  Time  Series  of  Monthly  Habitats 


Introduction 

The  State  of  the  art  when  doing  an  instream  flow  analysis 
is  to  do  an  analysis  of  monthly  habitat  values.  Most  of  the 
time,  the  average  monthly  streamflow  is  transformed  to 
monthly  physical  habitat  from  the  relation  between  the 
physical  habitat  and  streamflow  determination  using 
PHABSIM  (Figs.  7.1  and  7.2). 

The  HABTD  (see  Chapter  6),  HABTS,  and  HABNET 
programs  are  available  to  develop  a  monthly  time  series  of 
habitats.  The  HABTS  program  calculates  monthly  habitat 
values  at  a  site  for  multiple  species  and  life  stages.  The 
HABNET  program  generates  a  networkwide  monthly 
habitat  time  series.  Habitat  values  may  be  temperature 
conditioned  at  the  option  of  the  user. 

Calculating  monthly  habitfit  time  series  is  the  easy  part; 
knowing  what  to  do  with  the  results  is  the  more  difficult 
part  and  will  be  partially  addressed  in  Chapter  8.  The 
programs  described  in  Chapter  7  calculate  the  habitat 
area  associated  with  the  input  time  series  of  streamflow. 
The  resulting  habitat  time  series  can  then  be  graphed  to 
illustrate  the  frequency  of  periods  when  habitat  values 
seem  to  be  limiting,  or  the  results  can  be  statistically 
tabulated  to  either  summarize  the  probabilities  of  ex¬ 
ceeding  certain  levels  of  habitat  or  integrate  the  habitat 
values  over  time. 

Either  analysis  technique  may  be  used  when  comparing 
one  alternative  water  management  scenario  with  another  or 
with  the  baseline  conditim.  In  multiple  streamflow  scenar¬ 
ios,  the  habitat  time  series  programs  would  need  to  be  run 
repeatedly  (mce  for  each  set  of  streamflow  data)  and  each 
rekilting  habitat  time  series  data  file  would  need  to  be  saved 
with  a  different  name  for  subsequent  comparison. 

We  usually  assume  that  the  habitat-versus-flow  relation 
does  not  change  from  one  alternative  set  of  streamflows  to 
another.  However,  always  question  that  assumption.  It 
could  be  that  one  alternative  will  result  in  channel  change, 
another  in  changing  water  quality,  another  in  periodicity 
changes  due  to  migration  blockages  or  temperature 
change.  Simply  running  alternative  flow  scenarios  without 
asking  yourself  about  the  physical  or  biological  conse¬ 
quences  is  inappropriate. 


Calculation  of  Habitat  Time  Series 


Monthly  Habitat  Time  Series  Generation 
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GENERATING  HABITAT  TIME  SERIES 


TIME 


Fig.  7.2.  Generating  habitat  time  series. 


Monthly  Habitat  Time  Series  Generation 

Program  BatdVPtocedure 

Name  Filename  Rincdon  _ Program  PesciipticMi _ 

HABTS  RHABTS  Monthly  habitat  Creates  a  monthly  physical  habitat  time  series  file  for  multiple  species 

time  series  and  life  stages.  The  program  calculates  monthly  habitat  values  at  the 

generaticm  site,  using  linear  or  nonlinear  interpolation,  for  each  species,  each  life 

stage. 

RHABTS,  ZHAQF,  ZMONQ,  ZMTS,  ZOUT 
ZHAQF  =  Habitat-versus-flow  file  (input). 

ZMONQ  =  Monthly  streamflow  file  in  USGS  or  NWDC  format  (in¬ 
put). 

ZMTS  ”  Monthly  habitat  time  series  file  with  multiple  records  in 
the  same  format  as  the  ZMONQ  file  (output). 


ZOUT  =  HABTS  results  (output). 
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Program  BatdVProcethire 

Name  Filename  Rmction  Program  Descripdan 


HABNET  RHABNET  Networkwide 

monthly  habitat 
time  series 
generadoti 


Generates  a  networkwide  monthly  habitat  time  series.  Habitat  values 
may  be  temperature  conditioned  at  the  optical  of  the  user. 

RHABNET,  ZHABIN,  ZMTS,  ZMTSM,  ZHAQFM,  ZTEMP, 
ZTSI,ZOUT 


ZHABIN  *  HABNET  input  file  created  by  HABINN  (input). 

ZMTS  =  Habitat  time  series  data  (output).  Will  be  in  the  same  for¬ 
mat  as  ZMTSM. 


ZMTSM  =  Modified  monthly  flow  time  series  in  USGS  or  NWDC 
format  (input).  Can  be  a  multirecord  file. 

ZHAQFM  =  Modified  habitat  area-versus-flow  file  with  month  indi¬ 
cators  and  minimum  habitat  values  (input).  This  file 
can  be  created  by  the  HQFMON  program. 

ZTEMP  *  Temperature  time  series  data  in  USGS  or  NWDC  format 
or  a  free-formatted  file  with  parameters  for  a  temperature- 
versus-fiow  relation  (optional  input).  The  free-formatted 
file  can  be  created  with  the  QTEM  program  or  type 
INFOTQ  for  information  on  the  format  of  the  free-for¬ 
matted  file. 


ZTSI  *  Network  temperature  suitability  criteria  file  or  FISHCRV 
file  with  temperature  suitability  criteria  (optional  input). 
Type  INFOTSI  for  information  on  the  format  of  the  network 
temperature  suitability  criteria  file. 


ZOUT  =  HABNET  results  (output). 


Monthly  Habitat  Time  Series  Generation 
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Creation  of  Input  Files  for  the  HABNET  Program 


Program  Batch/Proceduie 
Name  Filename  Rmetion 

HABINN  RHABINN  HABNET 

options 
file  creation 


HQFMON  RHQFMON  HABNET 

ZHAQFM 
file  creation 


QTEM  RQTEM 


HABNET 
ZTEMP 
file  creation 


_ Program  Description _ 

Builds  a  HABNET  options  file. 

RHABINN,  ZHABIN 

ZHABIN  “  HABNET  options  file  (output). 

Adds  month  indicators  and  minimum  habitat  values  to  a  habitat  area- 

versus-streamflow  file. 

RHQFMON,  ZHAQF,  ZHAQFM 

ZHAQF  =  Habitat  area-versus-streamflow  file  (input). 

ZHAQFM  ~  Habitat  area-versus-streamflow  file  with  month  indica¬ 
tors  and  minimum  habitat  values  (output).  An  extra  ti¬ 
tle  line  and  segment  ID  line  can  also  be  added  if  they 
were  not  previously  entered  with  an  editor. 

Generates  a  temperature  versus  flow  equation  file. 

RQTEM,  ZTEMP 


ZTEMP  *  Free-formatted  flow  versus  temperature  equation  file  (out¬ 
put). 
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HABINN  Program 


Introduction 

The  HABINN  program  builds  a  HABNET  options  file. 
This  file  contains  information  on  which  river  segments  to 
process,  which  species  and  life  stages  to  process,  what 
period  (both  in  years  and  months)  to  process,  the  segment 
lengths,  and  the  format  of  the  temperature  suitability  cri¬ 
teria  file  (ZTSI).  With  this  information,  comparisons  may 
be  made  across  both  time  and  space  for  any  biological 
requirement. 

Figure  7.3  contains  a  sample  HABNET  input  file  created 
by  the  HABINN  program.  The  file  format  for  a  HABINN 
file  is  included  in  Appendix  A. 

Running  HABINN 

RHABINN,  ZHABIN 


rxtn  m$t)  hay  m 

jettaER  lttrtW)RK  tBHRSERttJRE  EOttAEltltV  nt£  RQRHaT 
m  EHABSIH  FX9HCRV  FXLE  FORMMP. 

ENTERr  0  FOR  ao  tEMEEERttmE  EOJtAEXtm  IW>EX  ftiS 

t  vm  MsrrwoRK  vmmAvm  stability  index  pile 
_ t  POE  riEKCEV  FILE 


The  QTEM  program  generates  a  network  temperature 
suitability  index  file.  A  FISHCRV  file  is  created  by  the 
PHABSIM  program,  GCURV. 


tHB  HABNET  PROOBAH  ASSOhffiS  THAT  YOOR  UNITS  ARE  EITHER 
METRIC  OR  ENOtlSH. 

IF  YOU  SPECIFY  METRIC,  THE  PROGRAM  ASSUMES  THAT  THE 
FLOW  DATA  IS  IN  CMS  AND  THE  SEGMENT  LENGTH  IS  IN 
KILOMETERS . 

IF  YOU  SPECIFY  ENGLISH,  THE  PROGRAM  ASSXWES  THAT  THE 
nx>W  DATA  1$  IN  CrS  AND  THE  SEGMENT  LENGTH  IS  IN  MILES. 

ENTER:  0  FOR  METRIC  UNITS 
_ 1  FOR  ENGLISH  UNITS 


ZHABIN  “  HABNET  options  file  (output). 


ENTER  TITLE  LINE  FOR  HABNET  INPUT  FILE  (flO  CHAR  MAX)  S;VV;4 


This  title  line  will  be  written  to  the  habitat  time  series 
file  (ZMTS)  and  output  file  (ZOUT)  from  HABNET. 


POUDRE  RIVER  TOTAL 
TEMP  FORMAT  1 
ENGLISH  UNITS 
WY : KSQFT 

FIRST  YEAR  OF  DATA 
LAST  YEAR  OF  DATA 
MONTHS 
1  SEG  1.5 
1  SEG  1.4 
1  SEG  1.1 
1  SEG  2.2 
1  SEG  3 . 3 
1  SEG  4.1 
1  SEG  4.2 
*********1 

1  BROWN 
1  BROWN 
1  BROWN 
1  BROWN 
1  RAINBOW 
1  RAINBOW 
1  RAINBOW 
1  RAINBOW 


NETWORK  ANALYSIS 


1954 

1983 

111111111111 

8.0 

38.0 

6.3 

4.9 

5.1 

1.0 

6.3 


?U3ULT 

JUVENILE 

FRY 

SPAWNING 

ADULT 

JUVENILE 

FRY 

SPAWNING 


******* 


Fig.  73.  Sample  input  file  for  HABNET  created  by  HABP4N. 


If  English  units  are  being  used,  the  calculations  will  be 
in  thousands  of  square  feet  (KSQFT).  If  metric  units  are 
being  used,  the  calculations  will  be  thousands  of  square 
meters  (KSQM). 

ENTER  THE  YEAR  CODE  FOR  THE  DATA  U  CHAR)  IN  CAPITAL  LETTERS 
AY  **  agricultural  year 

CY  -  CALENDAR  YEAR 
WY  ^  MATER  YEAR 

iiiiiiiliiiiiiiMi 


Note:  The  months  should  be  in  the  same  format  for  all 
input  files  (ZHABIN,  ZMTSM,  ZHAQFM,  and 
ZTEMP) — that  is,  all  in  water  years,  calendar 
years,  and  so  forth. 


ENTER  FIRST  YEAR  OF  DATA  TO  BE  INCLUDED  IN  PROCESSING f 
ENTER  LAST  YEAR  OF  DATA  TO  BE  INCLUDED  IN  PROCESSING: 


If  years  entered  here  are  out  of  range  with  the  data  in  the 
gaging  station  flow  file  (ZMTSM  file  also  used  as  input  to 
HABNET),  then  the  defaults  are  to  use  the  first  and  last 
years  of  gaging  staticm  data  from  the  ZMTSM  file. 


HABNET  allows  YQU  TO  INCLUDE  ONLY  THE  MCWHS  THAT  ARE 
LOGICAL  FOR  PROCESSING.  A  "1*  II®ICATES  THAT  THE 
MONTH  IS  TO  BE  INCLUDED  IN  PROCESSING.  A  ^0^ 

INDICATES  THAT  THE  MONTH  IS  NOT  TO  BE  INCLUDED* 

ENTER  X  OR  Q  FOR  EACH  MONTH  tnead  cbaracteis] . 

EXAMPLE;  XlDllllOOUX 

5  looooooooooa 
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In  this  example,  if  the  data  is  in  water  years,  October 
would  be  the  only  month  processed. 

The  processing  of  each  month  is  determined  from  both 
the  HABNET  input  file  (ZHABIN)  and  the  habitat-versus- 
flow  file  with  month  indicators  (ZHAQFM).  Both  month 
indicators  must  be  “on”  to  be  processed.  Some  examples 
follow: 

•  If  month  indicator  is  1  in  ZHABIN  and  1  in 
ZHAQFM,  then  that  month  will  be  processed  for  that 
species,  life  stage,  and  location. 

•  If  month  indicator  is  1  in  ZHABIN  and  0  in 
ZHAQFM,  that  month  will  not  be  processed  for  that 
species,  life  stage,  and  location. 

•  If  month  indicator  is  0  in  ZHABIN  and  1  in 
ZHAQFM,  that  month  will  not  be  processed  for  that 
species,  life  stage,  and  location. 

•  If  month  indicator  is  0  in  ZHABIN  and  0  in 
ZHAQFM,  that  month  will  not  be  processed  for  that 
species,  life  stage,  and  location. 


HABNET  PROCESSES  DATA  BY  SEGMENTS .  SEGMENTS  IN  THE 
INPUT  FILE  ARE  DESIGNATED  BY  A  SEGMENT  ID  (8  CHARACTERS) . 
CROSS  SECTIONS  AND  CROSS  SECTION  ID'S  MAY  ALSO  BE  USED. 
THE  SEGMENT  ID'S  FOR  THE  DATA  TO  BE  PROCESSED  MUST 
HAVE  A  HATCHING  SEGMENT  ID  ON  EACH  OP  THE  DATA  FILES. 

ENTER  segment  ID  (8  CHAR  MAX)  OR  0  TO  OUIT  ENTERING 
SEGMENT  ID' St _ 


The  segment  ID  numbers  have  to  match  exactly  with 
the  segment  ID  numbers  read  from  the  gaging  station 
data  file  (ZMTSM),  the  habitat  area-versus-streamflow 
file  (ZHAQFM),  and  the  temperature  time  series  or 
temperature-versus-flow  relation  file  (ZTEMP). 


At  least  one  segment  must  be  processed.  The  program 
will  terminate  with  a  fatal  error  if  there  are  no  segments. 

ENTER  THE  SEGMENT  LENGTH} 


This  downstream  distance,  measured  in  miles  or  kilome¬ 
ters,  is  the  multiplier  for  the  WUA.  The  downstream  distance 
is  the  segment  length  for  which  one  assumes  that  the  PHAB- 
SIM  hydraulics  and  preference  criteria  apply.  Note  that  if 
one  scenario  calls  for  a  reservoir  that  will  inundate  part  or 
all  of  a  biological  segment,  you  must  account  for  that 
inundation  by  adjusting  the  segment  length.  Also,  this  dis¬ 
tance  may  be  adjusted  to  account  for  a  life  stage  weight. 


Enter  the  information  (segment  ID,  whether  or  not  to 
include  the  segment  in  the  processing,  and  the  segment 
length)  for  each  segment  in  the  network. 


When  Q  is  entered  to  quit  entering  segments,  the  follow¬ 
ing  prompts  will  appear: 


SPECIES  AND  LIFE  STAGE  FOR  HABNET  PROCESSING i 
ENTER  SPECIES  <10  CHAR  MAX),  OR  TO  gtXtT 
ENTERING  SPECIES! 

ENTER  LIFE  STAGE  <10  CHARACTERS  MAXlHUM)  i 

THIS  LIFE  STAGE  WILL  BE  INCLUDED  C«J  YOUR  INPUT  FILE; 

HOWEVER.  YOD  MAY  WISH  TO  EKCtqpE  THIS  LIFE  STAGE  FROM 
PROCESSING. 

ENTER  1  TO  INCLUDE  THIS  LIFE  STAGE  IN  PROCESSING 
_ 0  TO  feXCLtfl>B  THIS  LIFE  STAGE  FROM  PROCESSING 

When  Q  is  entered  to  quit  entering  species  and  life  stages, 
the  HABNET  input  file  (Fig.  7.3,  sample)  will  be  created. 


THIS  SEGMENT  ID  WILL  APPEAR  ON  YOUR  INPUT  FILE; 
HOWEVER,  YOU  MAY  WISH  TO  EXCLUDE  THIS  SEGMENT  FROM 
PROCESSING, 

ENTER  ;:;!  -  SEGMENT  IN  PROCESSING 

_ 0  TO  EXCLUDE  THIS  SEGMENT  FROM  PROCESSING . 
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Introduction 

The  HABNET  program  generates  a  networkwide 
monthly  habitat  time  series.  Habitat  values  may  be  tem¬ 
perature  conditioned  at  the  option  of  the  user. 

Input  to  the  HABNET  program  is:  (1)  an  options  file 
created  by  the  HABINN  program  (ZHABIN  file);  (2)  a 
habitat  area-versus-flow  file  with  month  indicators  and 
minimum  habitat  values  created  by  the  HQFMON  pro¬ 
gram  (ZHAQFM  file);  (3)  a  gaging  station  flow  data  file  in 
uses  or  NWDC  format  (ZMTSM  file);  (4)  a  temperature 
data  file  in  USGS  or  NWDC  format  or  a  free-formatted 
file  with  empirically  derived  parameters  for  a  temperature- 
versus-flow  relation  (ZTEMP  file);  and  (5)  a  temperature 
criteria  file  in  FISHCRV  format  or  a  free-formatted  file 
with  temperature  suitability  criteria  (ZTSI  file).  Figure  7,4 
diagrams  the  flow  of  information  through  the  HABNET 
program. 

Rows  in  the  gaging  station  flow  data  file  (ZMTSM)  are 
matched  with  the  habitat-versus-flow  relation  with  month 
indicators  and  minimum  habitat  values  (ZHAQFM  file)  for 
one  or  more  life  stages  at  one  or  more  geographic  locations. 
It  will  optionally  modify  that  habitat  value  with  temperatures 
provided  to  produce  a  networkwide  habitat  time  series  for 
each  unique  life  stage.  The  temperature-induced  habitat 
modification  is  accomplished  with  the  use  of  a  temperature- 
versus-suitability  index  relation  for  each  life  stage.  If  used, 
the  suitability  for  temperature  (between  0  and  1)  is  simply 
multiplied  by  the  normal  WUA  value.  Though  calculations 
are  indepenint  of  any  given  time  step,  the  output  files  do 
assume  a  monthly  format. 

Units,  with  the  exception  of  segment  length,  are  arbitrary 
and  it  is  up  to  the  user  to  make  sure  that  they  match  between 
files.  You  will  be  safe  if  the  weighted  usable  area  (WUA) 
data  is  in  ft^/l,0(X)  ft  per  cfs  and  flows  are  in  cfs.  If 
temperature  values  are  given  in  ®F,  then  the  temperature 
suitability  index  curve  must  be  in  °F. 

The  usable  area  for  each  life  stage  is  calculated  through 
time  and  space.  At  each  segment,  the  routine  determines 
which  months  are  applicable.  Any  life  stage  may  be  in 
different  geographic  locations  at  different  times  of  the  year 
to  account  for  migration  or  movement.  Applicability  of 
each  month  is  determined  both  from  the  HABNET  input 
file  (ZHABIN)  and  the  habitat-versus-flow  file  with 
month  indicators  (ZHAQFM).  Both  month  indicators  must 
be  “on”  to  be  applicable.  If  applicable,  the  flow  is  deter¬ 
mined  and  the  corresponding  WUA  is  interpolated  from 
the  habitat-versus-flow  relation.  If  the  flow  is  less  than  the 
lowest  flow  in  the  curve,  or  greater  than  the  highest  flow, 
a  message  is  printed  and  the  WUA  is  set  to  zero. 


Next,  the  corresponding  temperature  value  is  retrieved 
either  from  reading  it  directly  from  the  temperature  time 
series  data  or  calculated  using  a  temperature-versus-flow 
relation  with  empirically  derived  parameters  provided  in  the 
ZTEMP  file.  The  suitability  index  (SI)  value  is  interpolated 
from  the  SI  curve  taken  from  the  ZTSI  file  in  either  RSH- 
CRV  or  network  temperature  suitability  file  format.  Again, 
if  the  temperature  falls  below  the  lowest  point  in  the  SI  curve 
or  above  the  highest  point,  a  message  is  printed  and  the  SI 
value  is  set  to  zero.  The  SI  value  is  multiplied  by  the  WUA 
and  the  segment  length  to  give  total  habitat.  If  fliere  are  no 
SI  and  temperature  data  supplied  for  a  particular  life  stage, 
then  this  process  does  not  occur.  Instead,  the  WUA  is 
multiplied  by  the  segment  length  to  give  total  habitat.  If, 
however,  temperature  data  have  been  only  partially  pro¬ 
vided  for  a  life  stage,  then  the  processing  of  the  life  stage  is 
skipped  and  no  time  series  data  are  produced.  This  is  to 
ensure  that  data  will  not  be  produced  for  one  life  stage 
containing  both  temperature-conditioned  and  iKwntempera- 
tme-ccwiditioned  habitat  values. 

This  process  repeats  for  all  applicable  segments.  Any 
segment  for  which  there  is  no  weighted  usable  area- 
versus-flow  curve  for  a  life  stage  is  ignored.  TTie  total  area 
for  all  segments  for  each  life  stage  is  added  together  to 
complete  the  networkwide  approach.  Finally,  each  year’s 
worth  of  data  is  written  to  the  habitat  time  series  data  file 
(ZMTS).  Inapplicable  months  are  assigned  a  value  of 
l.E-99  to  be  distinguished  from  zero.  Note  that  if  a  life 
stage  is  found  at  one  segment  during  October,  but  not 
at  another  segment  in  that  same  month,  only  applicable 
segmentHnonth  combinations  will  be  summed. 

Current  program  limits  are  listed  here;  however,  most 
limits  may  be  changed  by  altering  the  parameter  state¬ 
ments  in  the  source  code  and  recompiling. 


Maximum  number  of  segments  or  gaging  stations  50 

Maximum  number  of  life  stages  10 

Maximum  number  of  points  in  HA-versus-Q  curve  30 

Maximum  number  of  years  None 

Maximum  number  of  time  steps  per  year  12 

Minimum  number  of  time  steps  per  year  12 

Maximum  number  of  points  in  a  T-SI  curve  15 


Notes  regarding  the  HABNET  program: 

1.  When  setting  up  your  gaging  station  data  set,  you 
must  remember  to  account  for  the  physical  habitat 
sites  in  the  network  description.  General  guidelines 
would  call  for  establishing  a  segment  wherever  there 
is  likely  to  be  a  change  in  flow  of  >10%  through  a 
habitat  site.  In  this  way,  accurate  translation  of  flow 
to  habitat  value  may  be  retained. 


Segments,  /  - 

Wastages,  /  HABINN  i 

etc.  / - -  - 4  ODtionsfile 


n 


L 
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2.  Aside  from  assembling  all  of  the  habitat  area- versus- 
streamflow  data  files  (known  as  ZHAQF’s  in  PHAB- 
SIM)  into  a  single  file,  there  remains  at  least  one 
important  task:  The  upper  and  lower  bounds  of  each 
curve  should  be  examined  for  their  ability  to  handle 
the  extremes  of  yearly  flows  likely  to  be  encountered. 
HABNET  does  no  curve  extrapolation  (as  do  some 
other  TSLIB  routines).  K  a  flow  is  encountered  out¬ 
side  the  bounds  of  a  life  stage’s  curve,  the  habitat 
value  is  set  to  zero.  A  warning  message  is  issued,  but 
it  is  the  user’s  responsibility  to  provide  reasonable 
extrapolations  or  accept  the  consequences.  This  ap¬ 
proach  is  more  prudent  than  extrapolation,  because 
pure  mathematical  extrapolation  is  not  often  hy- 
drologically  or  biologically  acceptable. 

3.  We  have  made  much  use  of  TSLIB  plotting  and 
duration  analysis  programs  to  continue  the  analysis 
of  the  results  of  HABNET.  Typically,  you  would  use 
GETl  to  extract  single  life  stages  as  records  from  the 
habitat  time  series  file  (ZMTS)  to  be  used  as  input  to 
programs  such  as  LPTDUR  and  LPTTSN.  Links  to 
the  effective  habitat  time  series  programs  should  be 
performed  in  the  same  way. 

The  HABNET  program  is  a  member  of  a  family  of 
programs  in  the  network  habitat  analysis  family.  This 
group  includes: 

LNKQ2T  —  HYDROSS  to  temperature  model, 

LNKT2H  —  Temperature  to  habitat  model, 

LNKQ2H  —  HYDROSS  to  habitat  model,  and 

LNKT2TS  —  Temperature  to  time  series  program. 

Refer  to  Bartholow  and  Waddle  (1986)  for  documen¬ 
tation  on  the  other  programs.  (Note:  The  HABNET  pro¬ 
gram  replaces  the  LNKG2H  program  in  Bartholow  and 
Waddle  1986.)  See  also  the  PHABSIM,  HYDROSS,  and 
temperature  model  documentation. 

Running  HABNET 

RHABNET,  ZHABIN,  ZMTS,  ZMTSM,  ZHAQFM, 

ZTEMgZTSI,  ZOUT 

ZHABIN  =  HABNET  input  file  created  by  HABINN 
(input). 

ZMTS  ~  Habitat  time  series  data  (output).  Will  be 
m  same  format  as  ZMTSM. 

ZMTSM  =  Modified  monthly  flow  time  series  in 
USGS  or  NWDC  format  (input).  Can  be 
a  multirecord  file. 


ZHAQFM  *  Modified  habitat  area-versus-flow  file 
with  month  indicators  and  minimum 
habitat  values  (input).  This  file  can  be 
created  by  the  HQFMON  program. 

ZTEMP  =  Temperature  time  series  data  in  USGS  or 
NWDC  format  or  a  free-formatted  file 
with  parameters  for  a  temperature-ver- 
sus-flow  relation  (optional  input).  The 
free-formatted  file  can  be  created  with 
the  QTEM  program  or  type  INFOTQ  for 
information  on  the  format  of  the  free-for¬ 
matted  file. 

ZTSI  -  Network  temperature  suitability  criteria 
file  or  FISHCRV  file  with  temperature 
suitability  criteria  (optional  input).  Type 
INFOTSI  for  information  on  the  format 
of  the  network  temperature  suitability 
criteria  file. 

ZOUT  -  HABNET  results  (output). 

The  following  is  information  on  the  format  for  the 
modified  monthly  flow  time  series  file  (ZMTSM)  and  the 
temperature  suitability  criteria  file.  The  ZHABIN  file  is 
created  by  the  HABINN  program,  the  modified  habitat 
area-versus-flow  (ZHAQFM)  file  is  created  by  the 
HQFMON  program,  and  the  ZTEMP  file  is  either  in 
USGS  or  NWDC  format  or  is  a  free-formatted  file  cre¬ 
ated  by  the  QTEM  program.  Refer  to  the  individual 
program  documentation  for  information  on  these  files. 

ZMTSM,  This  file  is  a  standard  monthly  time  series 
(ZMTS)  file  with  the  exception  of  the  “DITTO”  option 
and  one  title  line  before  each  gaging  station  or  segment. 
These  changes  can  be  made  with  an  editor.  The  ZMTSM 
file  contains  monthly  flow  data  for  gaging  stations  or 
segments.  It  is  organized  by  gaging  stations  or  segments 
and  then  by  year  and  months  within  stations  or  segments. 
Appendix  A  contains  a  sample  ZMTSM  file  and  the  file 
format. 

ZTSL  ZTSI  is  a  network  temperature  suitability 
criteria  file  or  FISHCRV  file  with  temperature  criteria 
(optional  input).  Type  INFOTSI  for  information  on  the 
free-formatted  network  temperature  suitability  criteria  file. 
The  FISHCRV  file  is  created  with  the  GCURV  Program 
in  PHABSIM.  Appendix  A  contains  a  sample  ZTSI  file 
in  free-formatted  network  temperature  suitability  criteria 
format  and  the  file  format. 

There  are  two  output  files:  the  HABNET  results 
(ZOUT)  and  the  habitat  time  series  file  (ZMTS). 

The  ZOUT  file  contains  a  complete  description  of  how 
the  program  runs,  the  sequence  of  events,  warning  and 
fatal  error  messages,  and  the  summary  report  containing 
life  stage  statistics.  Study  this  output  file  carefully — ^it 
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will  be  an  inunense  help  in  ensuring  that  you  have  set  up  along  with  the  date  and  time  of  the  run.  Sample  ZOUT 
your  data  files  correctly.  It  will  also  be  Invaluable  as  a  output  is  presented  in  Fig.  7.5. 
record  of  what  you  did  to  accomplish  a  certain  option. 


************************#********i^*******«««*«*^^ 

*  TIME  SERIES  LIBRARY  PROGRAMS  * 

*  AQUATIC  SYSTEMS  BRANCH,  USFWS  * 

*  VERSION  2.1  FEBRUARY,  1990  * 

*  RUN  DATE  90/05/22.  TIME  11.37.12.  * 
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PROGRAM  HABNET  VERSION  NUMBER  2.0 
LAST  MODIFIED  MAY,  1990. 


FILES  USED  IN  PROCESSING  HABNET  RUN; 


habin.dat 
habnet .mts 
mtsm.dat 
haqfm .dat 
tempi . dat 
tsi .dat 
habnet . out 


=  HABNET  INPUT  FILE 
=  MONTHLY  HABITAT  TIME  SERIES  FILE 
=  MODIFIED  MONTHLY  FLOW  TIME  SERIES  FILE 
=  MODIFIED  HABITAT -VS -FLOW  FILE 
=  TEMPERATURE  DATA  FILE 
=  TEMPERATURE  SUITABILITY  INDEX  FILE 
»  HABNET  RESULTS 


*********************************^^^^^^ 

PROCESSING  MONTHLY  FLOW  FILE:  mtsm.dat 

NETWORK  GAGING  STATION  DATA  CACHE  LA  POUDRE  -  USGS  FORMAT 
MEAN  MONTHLY  FLOWS  (CFS) 

FROM  YEARS  1954  TO  1983 

THE  MONTHLY  FLOW  FILE  CONTAINS  THE  FOLLOWING  SEGMENTS: 

SEGMENT#  SEGMENT  TITLE  /  SEGMENT  ID 


1  POUDRE  RIVER  SEGMENT  1  SITE  5  FLOWS  (NOTE;  SAME  FLOW  THRU  1) 
SEGMENT  ID:  SEG  1.5 

2  POUDRE  RIVER  SEGMENT  1  SITE  4  FLOWS  (NOTE:  FLOWS  SAME  AS  1.5) 
SEGMENT  ID:  SEG  1.4 

***  SEGMENT  2  IS  A  DITTO  SEGMENT,  COPIED  FROM  SEGMENT:  SEG  1.5 

3  POUDRE  RIVER  SEGMENT  1  SITE  1  FLOWS  (NOTE:  FLOWS  FROM  2.2) 
SEGMENT  ID:  SEG  1.1 

4  POUDRE  RIVER  SEGMENT  2  SITE  2  FLOWS 
SEGMENT  ID:  SEG  2.2 

***  SEGMENT  4  IS  A  DITTO  SEGMENT,  COPIED  FROM  SEGMENT:  SEG  1.1 

5  POUDRE  RIVER  SEGMENT  3  SITE  3  FLOWS 
SEGMENT  ID :  SEG  3 . 3 

6  POUDRE  RIVER  SEGMENT  4  SITE  1  (NORTH  FORK)  FLOWS 
SEGMENT  ID:  SEG  4.1 

7  POUDRE  RIVER  SEGMENT  4  SITE  2  FLOWS  (NOTE:  SAME  AS  4.1) 
SEGMENT  ID:  SEG  4.2 

***  SEGMENT  7  IS  A  DITTO  SEGMENT,  COPIED  FROM  SEGMENT:  SEG  4.1 

END  OF  PROCESSING  MONTHLY  FLOW  DATA  FILE:  mtsm.dat 


Fig.  7.5.  Sample  output  from  the  HABNET  program. 
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*************************************** 

PROCESSING  SPECIES/LIFE  STAGE  Q-WUA  DATA  FILE:  haqfm.dat 

SEGMENT#  SEGMENT  TITLE 

SEGMENT  ID 

LIFE  STAGE#  AND  NAME  VALID  MONTHS  MINIMUM  HABITAT  VALUE  #  OF  POINTS 


1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

1  BROWN  ADULT 

111111111111 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

2  BROWN  JUVENILE 

111111111111 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

3  BROWN  FRY 

000000011110 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID;  SEG  1.5 

4  BROWN  SPAWNING 

110000000000 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

5  RAINBOW  ADULT 

111111111111 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEC34ENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

6  RAINBOW  JUVENILE 

111111111111 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

7  RAINBOW  FRY 

000000001110 

0.000 

13 

POINTS 

1  POUDRE  RIVER  SEGMENT 

1  SITE  5 

SEGMENT  ID:  SEG  1.5 

8  RAINBOW  SPAWNING 

000000110000 

0.000 

13 

POINTS 

2  POUDRE  RIVER  SEGMENT 

1  SITE  4 

SEGMENT  ID:  SEG  1.4 

1  BROWN  ADULT 

111111111111 

0.000 

13 

POINTS 

2  POUDRE  RIVER  SEGMENT 

1  SITE  4 

SEGMENT  ID:  SEG  1.4 

2  BROWN  JUVENILE 

111111111111 

0.000 

13 

POINTS 

2  POUDRE  RIVER  SEGMENT 

1  SITE  4 

SEGMENT  ID:  SEG  1.4 

3  BROWN  FRY 

000000011110 

0.000 

13 

POINTS 

2  POUDRE  RIVER  SEGMENT 

1  SITE  4 

SEGMENT  ID:  SEG  1.4 

4  BROWN  SPAWNING 

110000000000 

0.000 

13 

POINTS 

Sections  of  sample  output  deleted  here  for  brevity. 


END  OF  PROCESSING  SPECIES/LIFE  STAGE  Q-WUA  DATA  FILE:  haqfm.dat 
YOU  HAVE  56  ENTRIES  AND  8  UNIQUE  LIFE  STAGE (S) . 

************************************** 

PROCESSING  TEMPERATURE  DATA  FILE:  templ.dat 

NETWORK  TEMPERATURE  DATA  CACHE  LA  POUDRE  -  USGS  FORMAT 
MEAN  MONTHLY  TEMPERATURE  (DEGREES  F) 

FROM  YEARS  1954  TO  1983 

THE  TEMPERATURE  DATA  OUTPUT  CONTAINS  THE  FOLLOWING  NODES: 

SEGMENT#  SEGMENT  TITLE  /  SEGMENT  ID 


1  POUDRE  RIVER  SEGMENT  1  SITE  5 
SEGMENT  ID:  SEG  1.5 

2  POUDRE  RIVER  SEGMENT  1  SITE  4 
SEGMENT  ID:  SEG  1.4 


Fig.  7  Continued. 
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***  SEGMENT  2  IS  A  DITTO  SEGMENT,  COPIED  FROM  SEGMENT;  SEG  1.5 

3  POUDRE  RIVER  SEGMENT  1  SITE  1 
SEGMENT  ID;  SEG  1.1 

4  POUDRE  RIVER  SEGMENT  2  SITE  2 
SEGMENT  ID;  SEG  2.2 

5  POUDRE  RIVER  SEGMENT  3  SITE  3 
SEGMENT  ID:  SEG  3.3 

6  POUDRE  RIVER  SEGMENT  4  SITE  1  (NORTH  FORK) 

SEGMENT  ID:  SEG  4.1 

7  POUDRE  RIVER  SEGMENT  4  SITE  2  FLOWS  (NOTE:  SAME  AS  SEGMENT  4  SITE  1) 
SEGMENT  ID;  SEG  4.2 

***  SEGMENT  7  IS  A  DITTO  SEGMENT,  COPIED  FROM  SEGMENT:  SEG  4,1 


END  OF  PROCESSING  TEMPERATURE  DATA  FILE:  templ.dat 


*************************************** 

PROCESSING  YOUR  HABNET  INPUT  FILE:  habin.dat 

POUDRE  RIVER  TOTAL  NETWORK  ANALYSIS 

UNITS  =  WY;KSOFT 

FIRST  YEAR  =  1954 
LAST  YEAR  =  1983 

FINISHED  VERIFYING  INCLUSIVE  YEARS  FROM  HABNET  INPUT,  FLOW,  AND  TEMPERATURE 
DATA  FILES.  YOUR  TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE 
PRODUCED  FOR  YEARS  1954  THROUGH  1983 

TEMPERATURE  CRITERIA  DATA  (IF  PRESENT)  IS  IN  FISHCRV  FILE  FORMAT. 

MONTHS  =  111111111111 


NODES  LIST 


1  POUDRE  RIVER  SEGMENT 
REACH  LENGTH:  8.000 


1  SITE  5  FLOWS  (NOTE:  SAME  FLOW  THRU  1) 


2  POUDRE  RIVER  SEGMENT 
REACH  LENGTH:  38.000 


1  SITE  4  FLOWS  (NOTE: 


FLOWS  SAME  AS  1.5) 


3  POUDRE  RIVER  SEGMENT 
REACH  LENGTH:  6.300 


1  SITE  1  FLOWS  (NOTE:  FLOWS  FROM  2.2) 


4  POUDRE  RIVER  SEGMENT 
REACH  LENGTH:  4.900 


2  SITE  2  FLOWS 


5  POUDRE  RIVER  SEGMENT  3  SITE  3  FLOWS 

REACH  LENGTH:  5.100 

6  POUDRE  RIVER  SEGMENT  4  SITE  1  (NORTH  FORK)  FLOWS 

REACH  LENGTH:  1.000 


7  POUDRE  RIVER 
REACH  LENGTH: 


SEGMENT  4  SITE  2  FLOWS  (NOTE:  SAME  AS  4.1) 
6.300 


LIFE  STAGES  LIST 


1  BROWN 

2  BROWN 

3  BROWN 

4  BROWN 

5  RAINBOW 

6  RAINBOW 

7  RAINBOW 

8  RAINBOW 


ADULT 

JUVENILE 

FRY 

SPAWNING 

ADULT 

JUVENILE 

FRY 

SPAWNING 


END  OF  PROCESSING  HABNET  INPUT  FILE:  habin.dat 


SEGMENT  ID:  SEG  1.5 


SEGMENT  ID:  SEG  1.4 


SEGMENT  ID:  SEG  1.1 


SEGMENT  ID:  SEG  2.2 


SEGMENT  ID:  SEG  3.3 


SEGMENT  ID:  SEG  4.1 


SEGMENT  ID:  SEG  4.2 


Fig.  7.5.  Continued 
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************************************** 

PROCESSING  SPECIES/LIFE  STAGE  TEMPERATURE -SI  DATA  FILE:  tsi.dat 
TEMPERATURE  -  SUITABILITY  INDEX  FILE  FOR  POUDRE  RIVER.  DATA  FROM  RALEIGH 

THE  FOLLOWING  LIFE  STAGES  WERE  FOUND  ON  YOUR 
TEMPERATURE  SUITABILITY  INDEX  FILE: 


1 

BROWN 

ADULT 

AVG 

0.00 

DEG 

HAS 

7 

DATA 

POINTS 

2 

BROWN 

JUVENILE 

AVG 

0,00 

DEG 

HAS 

6 

DATA 

POINTS 

3 

BROWN 

FRY 

AVG 

0.00 

DEG 

HAS 

6 

DATA 

POINTS 

4 

BROWN 

SPAWNING 

AVG 

0.00 

DEG 

HAS 

6 

DATA 

POINTS 

5 

RAINBOW 

ADULT 

AVG 

0.00 

DEG 

HAS 

6 

DATA 

POINTS 

6 

RAINBOW 

JUVENILE 

AVG 

o 

o 

o 

DEG 

HAS 

6 

DATA 

POINTS 

7 

RAINBOW 

FRY 

AVG 

0.00 

DEG 

HAS 

9 

DATA 

POINTS 

8 

RAINBOW 

SPAWNING 

AVG 

0.00 

DEG 

HAS 

6 

DATA 

POINTS 

END  OF  READING  SPECIES/LIFE  STAGE  TEMPERATURE- SI  DATA  FILE:  tsi.dat 
YOU  HAVE  8  LIFE  STAGES  REPRESENTED. 


************************************** 

BEGINNING  TO  GENERATE  HABITAT  TIME  SERIES  FILE:  habnet.mts 
90/05/22.  11.37.12. 


SPECIES#  SPECIES  LIFESTAGE  RECORD  NAME 

1  BROWN  ADULT  =  BROWADU 

FOR  SPECIES/LIFE  STAGE:  BROWN  ADULT 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

2  BROWN  JUVENILE  =  BROWJUV 

FOR  SPECIES/LIFE  STAGE:  BROWN  JUVENILE 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

3  BROWN  FRY  =  BROWFRY 

FOR  SPECIES/LIFE  STAGE:  BROWN  FRY 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

4  BROWN  SPAWNING  =  BROWS PA 

FOR  SPECIES /LIFE  STAGE:  BROWN  SPAWNING 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

5  RAINBOW  ADULT  =  RAINADU 

FOR  SPECIES/LIFE  STAGE:  RAINBOW  ADULT 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

6  RAIN  JUVENILE  =  RAINJUV 

FOR  SPECIES/LIFE  STAGE:  RAINBOW  JUVENILE 

TEMPEBLATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

7  RAINBOW  FRY  =  RAINFRY 

FOR  SPECIES/LIFE  STAGE:  RAINBOW  FRY 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 

8  RAINBOW  SPAWNING  =  RAINS PA 

FOR  SPECIES/LIFE  STAGE:  RAINBOW  SPAWNING 

TEMPERATURE  CONDITIONED  HABITAT  TIME  SERIES  DATA  WILL  BE  PRODUCED. 


END  OF  HABITAT  TIME  SERIES  GENERATION 
DATA  IS  ON  FILE:  habnet.out 


************************************** 

BEGINNING  THE  REPORT  SECTION 


Fig.  75.  Continued. 
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MINIMUM  AREA  ENCOUNTERED  = 
AVERAGE  AREA  =  2064.  KSQFT 

MAXIMUM  AREA  ENCOUNTERED  = 
SEGMENT  PERCENT  DESCRIPTION 


237.6778  IN  YEAR  1967  MONTH  4 
PER  MONTH 

4546.9434  IN  YEAR  1977  MONTH  10 


1 

2 

3 

4 

5 

6 
7 


10.30 

POUDRE  RIVER 

SEGMENT 

1 

SEGMENT  ID: 

SEG  1.5 

40.26 

POUDRE  RIVER 

SEGMENT 

1 

SEGMENT  ID: 

SEG  1.4 

14.36 

POUDRE  RIVER 

SEGMENT 

1 

SEGMENT  ID: 

SEG  1.1 

7.74 

POUDRE  RIVER 

SEGMENT 

2 

SEGMENT  ID: 

SEG  2.2 

16.20 

POUDRE  RIVER 

SEGMENT 

3 

SEGMENT  ID: 

SEG  3.3 

1.07 

POUDRE  RIVER 

SEGMENT 

4 

SEGMENT  ID: 

SEG  4.1 

10.09 

POUDRE  RIVER 

SEGMENT 

4 

SEGMENT  ID: 

SEG  4.2 

SITE  5  FLOWS  (NOTE:  SAME  FLOW  THRU  1) 
SITE  4  FLOWS  (NOTE:  FLOWS  SAME  AS  1.5) 

SITE  1  FLOWS  (NOTE:  FLOWS  FROM  2.2) 

SITE  2  FLOWS 

SITE  3  FLOWS 

SITE  1  (NORTH  FORK)  FLOWS 

SITE  2  FLOWS  (NOTE:  SAME  AS  4.1) 


100% 


2  BROWN  JUVENILE 

MINIMUM  AREA  ENCOUNTERED  =  507.3422  IN  YEAR  1967  MONTH  4 

AVERAGE  AREA  =  3479.  KSQFT  PER  MONTH 

MAXIMUM  AREA  ENCOUNTERED  =  6688.0308  IN  YEAR  1954  MONTH  12 

SEGMENT  PERCENT  DESCRIPTION 


1 

13.14 

POUDRE  RIVER 

SEGMENT 

1 

SEGMENT  ID: 

SEG  1.5 

2 

43.26 

POUDRE  RIVER 

SEGMENT 

1 

SEGMENT  ID: 

SEG  1.4 

3 

14.78 

POUDRE  RIVER 

SEGMENT 

1 

SEGMENT  ID: 

SEG  1.1 

4 

7.94 

POUDRE  RIVER 

SEGMENT 

2 

SEGMENT  ID: 

SEG  2.2 

5 

12.46 

POUDRE  RIVER 

SEGMENT 

3 

SEGMENT  ID: 

SEG  3.3 

6 

0.95 

POUDRE  RIVER 

SEGMENT 

4 

SEGMENT  ID: 

SEG  4.1 

7 

7.46 

POUDRE  RIVER 

SEGMENT 

4 

SEGMENT  ID: 

SEG  4 . 2 

100% 


SITE  5  FLOWS  (NOTE:  SAME  FLOW  THRU  1) 
SITE  4  FLOWS  (NOTE:  FLOWS  SAME  AS  1.5) 

SITE  1  FLOWS  (NOTE:  FLOWS  FROM  2.2) 

SITE  2  FLOWS 

SITE  3  FLOWS 

SITE  1  (NORTH  FORK)  FLOWS 

SITE  2  FLOWS  (NOTE:  SAME  AS  4.1) 


Sections  of  sample  output  deleted  here  for  brevity. 


Fig.  7.5.  Continued 


Past  the  run  summary,  the  report  section  should  be  of 
particular  significance.  For  each  species  and  life  stage,  this 
section  lists 

1.  Life  stage  name, 

2.  Minimum  area  encountered, 

3.  When  minimum  occurred  (if  more  than  one  time, 
only  first  one  is  reported), 

4.  Average  area  encountered, 

5.  Maximum  area  encountered, 

6.  When  maximum  is  encountered  (if  more  than  time, 
only  first  one  is  reported),  and 

7.  Percentage  of  total  area  contributed  by  each  segment. 


The  ZMTS  file  contains  habitat  time  series  data.  This 
file  will  be  in  the  same  format  (USGS  or  NWDC)  as  the 
ZMTSM  file  used  as  input.  The  file  is  arranged  one  life 
stage  per  record,  with  record  titles  composed  of  the  first 
four  characters  of  the  species  name  and  the  first  three 
characters  of  the  life  stage  name.  It  may  be  convenient 
to  pull  one  record  at  a  time  from  this  file  by  using  the 
program  GETl.  Sample  output  is  presented  in  Fig.  7.6. 

Unlike  a  standard  USGS  or  NWDC  time  series  file,  this 
file’s  station  descriptor  says  SUM  because  the  habitat 
values  have  been  aggregated  over  a  network  and  no 
single  station  identifier  is  relevant.  The  title  of  the  habitat 
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BROWADU 

POUDRE  RIVER  TOTAL  NETWORK  ANALYSIS 


BROWN 

ADULT 

UNITS 

=  WY: 

:  KSQFT 

90/05/22. 

,  11.37, 

,  12  . 

SUM 

1 

1954 

1 

1803 

1042 

810.91 

685.06 

655.08 

753,52 

WY ; KSQFT 

SUM 

1 

1954 

2 

2428 

2663 

2912 

3821 

3533 

3991 

WY: KSQFT 

SUM 

1 

1955 

1 

2297 

930.00 

370.86 

411.86 

443.23 

575.25 

WY : KSQFT 

SUM 

1 

1955 

2  931.54 

27  03 

2703 

3499 

4063 

3726 

WY : KSQFT 

SUM 

1 

19  56 

1 

2411 

1063 

743 .71 

542.45 

505.56 

1019 

WY : KSQFT 

SUM 

1 

19  56 

2 

2066 

2306 

2693 

3812 

4280 

3629 

WY : KSQFT 

SUM 

1 

19  57 

1 

167  3 

777.99 

528.00 

425.15 

509 . 18 

713.84 

WY : KSQFT 

SUM 

1 

1957 

2 

1825 

3112 

2181 

2713 

3493 

3445 

WY : KSQFT 

SUM 

1 

1958 

1 

2612 

1197 

893 . 19 

652.27 

781.32 

127  8 

WY ; KSQFT 

SUM 

1 

1958 

2 

247  8 

2044 

2547 

3892 

4262 

3745 

WY : KSQFT 

SUM 

1 

1959 

1 

2684 

952.22 

552.57 

446.90 

846.58 

1425 

WY : KSQFT 

SUM 

1 

1959 

2 

2304 

2890 

2528 

3268 

3773 

3414 

WY : KSQFT 

SUM 

1 

1960 

1 

2219 

1743 

626.93 

449.00 

589.34 

137  8 

WY : KSQFT 

SUM 

1 

1960 

2 

2936 

2780 

2743 

3384 

4176 

3794 

WY: KSQFT 

SUM 

1 

1961 

1 

2190 

875.02 

495.94 

629.32 

579.19 

817  .74 

WY : KSQFT 

SUM 

1 

1961 

2 

2189 

2525 

227  0 

3726 

3470 

3844 

WY : KSQFT 

SUM 

1 

1962 

1 

3165 

1972 

1281 

1130 

1336 

1760 

WY: KSQFT 

SUM 

1 

1962 

2 

2937 

2324 

2497 

3054 

3567 

3725 

WY : KSQFT 

SUM 

1 

1963 

1 

2582 

1003 

671.50 

491.88 

608.88 

540.46 

WY : KSQFT 

SUM 

1 

1963 

2 

2495 

2721 

3027 

3887 

4019 

3711 

WY: KSQFT 

SUM 

1 

1964 

1 

1932 

1082 

409.66 

303.81 

390.17 

895.55 

WY : KSQFT 

SUM 

1 

1964 

2 

1671 

2873 

2951 

3302 

3953 

3794 

WY : KSQFT 

SUM 

1 

1965 

1 

2269 

694.20 

357.36 

303.81 

421.23 

544.91 

WY : KSQFT 

SUM 

#EOR 

BROWJUV 

POUDRE 

1  1965  2 

RIVER  TOTAL  NETWORK 

1991  2997 

ANALYSIS 

2199 

3124 

3417 

3901 

WY : KSQFT 

BROWN 

JUVENILE 

UNITS 

=  WY; 

:  KSQFT 

90/05/22 , 

,  11.37, 

.  12  . 

SUM 

2 

1954 

1 

3624 

2210 

1678 

1434 

1341 

1439 

WY : KSQFT 

SUM 

2 

1954 

2 

4781 

4461 

4131 

5257 

5317 

6688 

WY : KSQFT 

SUM 

2 

1955 

1 

4841 

1971 

787.35 

910.79 

913.92 

1136 

WY : KSQFT 

SUM 

2 

1955 

2 

1936 

4605 

3459 

4696 

5677 

6147 

WY : KSQFT 

SUM 

2 

1956 

1 

4698 

2411 

1676 

1209 

1134 

2167 

WY : KSQFT 

SUM 

2 

1956 

2 

4261 

3530 

3405 

5078 

6089 

6223 

WY : KSQFT 

SUM 

2 

1957 

1 

3603 

1727 

117  3 

939.58 

1124 

1537 

WY : KSQFT 

SUM 

2 

19  57 

2 

3749 

5541 

2741 

3269 

4759 

5481 

WY : KSQFT 

SUM 

2 

1958 

1 

5112 

2636 

1889 

1393 

1668 

2569 

WY : KSQFT 

SUM 

2 

1958 

2 

4676 

3415 

3295 

5161 

6030 

6280 

WY : KSQFT 

SUM 

2 

1959 

1 

537  8 

2047 

1189 

932.38 

1783 

2850 

WY : KSQFT 

SUM 

2 

1959 

2 

4295 

5051 

3233 

4303 

5298 

5802 

WY : KSQFT 

SUM 

2 

1960 

1 

4679 

3631 

1359 

951.38 

1202 

2886 

WY : KSQFT 

SUM 

2 

1960 

2 

5883 

4480 

3501 

4406 

5936 

6272 

WY : KSQFT 

SUM 

2 

1961 

1 

4454 

1955 

1104 

1333 

1243 

1829 

WY : KSQFT 

SUM 

2 

1961 

2 

4030 

4499 

2898 

5007 

4958 

6226 

WY : KSQFT 

SUM 

2 

1962 

1 

6115 

4079 

2784 

2493 

2857 

3660 

WY : KSQFT 

SUM 

2 

1962 

2 

5655 

3682 

3238 

3906 

5017 

6108 

WY : KSQFT 

SUM 

2 

1963 

1 

5026 

2071 

1370 

972 .71 

1239 

1072 

WY : KSQFT 

SUM 

2 

1963 

2 

4851 

4488 

4113 

5268 

5655 

6134 

WY : KSQFT 

SUM 

2 

1964 

1 

4095 

2375 

900.92 

669.03 

832  .75 

1810 

WY : KSQFT 

SUM 

2 

1964 

2 

3323 

4663 

3826 

4298 

5654 

6409 

WY : KSQFT 

SUM 

2 

1965 

1 

4427 

1500 

111  .28 

669.03 

908.76 

1212 

WY : KSQFT 

SUM 

#EOR 

2 

1965 

2 

4097 

4946 

2784 

3822 

4734 

6383 

WY : KSQFT 

Fig.  7.6.  Sample  habitat  time  series  (ZMTS)  file  from  HABNET.  Years  1966-83  deleted  for  brevity. 


time  series  file  comes  from  the  input  file  (ZHABIN).  The 
units  also  come  from  the  input  file. 

The  very  small  numbers,  l.E-99  (meaning  1  x  10“^), 
represent  months  in  which  the  life  stage  has  no  biological 
habitat  value.  2^ro  is  not  used  because  zero  can  be 
confused  with  a  realistic  value. 


HABNET  Error  Messages 

Messages  are  divided  into  two  categories:  warning  and 
fatal.  In  general,  warning  messages  will  not  cause  program 
termination;  the  job  will  do  its  best  to  continue.  Fatal 
errors,  however,  will  cause  either  immediate  or  delayed 
job  termination,  depending  on  the  circumstances.  TTie 
output  file  (ZOUT)  will  provide  a  summary  of  these 
messages. 
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HABNET  Input  File  (ZHABIN)  Warnings 

***  WARNING  0*** 

FOUND  [xxxx]  INSTEAD  OF  PROPER  UNITS.  (Unrec¬ 
ognized  units  found  on  your  HABNET  input  file.) 

***  WARNING  2  ***  TEMPERATURE  FORMAT 
MUST  BE  0,  1,  OR  2.  THE  FORMAT  ON  THE  INPUT 
FILE  IS:  [«]. 

***  WARNING  4  ***  INVALID  UNIT  TYPE: 
[xxxxxxxxx] 

FOUND  ON  YOUR  HABNET  INPUT  FILE,  LINE  3. 
(The  third  line  of  the  HABNET  input  file  must  be  either 
METRIC  UNITS  or  ENGLISH  UNITS.) 

***  WARNING  6  *** 

THE  FIRST  YEAR  REQUESTED  [year]  IS  OUT  OF 
THE  BOUNDS  OF  FLOW  DATA  [year]. 

I  WILL  START  WITH  THE  FIRST  YEAR  ON  THE 
FLOW  DATA  FILE. 

***  WARNING  8  *** 

THE  FIRST  YEAR  REQUESTED  [year]  IS  OUT  OF 
BOUNDS  OF  CORRESPONDING  FLOW  AND  TEM¬ 
PERATURE  DATA. 

I  WILL  START  WITH  THE  FIRST  YEAR  OF  CORRE¬ 
SPONDING  DATA  [year]. 

***  WARNING  10  *** 

THE  LAST  YEAR  REQUESTED  [year]  IS  GREATER 
THAN  THE  LAST  YEAR  OF  FLOW  DATA  [year]. 

I  WILL  END  WITH  THE  LAST  YEAR  OF  FLOW  DATA 
FILE. 

***  WARNING  12  *** 

THE  LAST  YEAR  REQUESTED  [year]  IS  OUT  OF 
BOUNDS  OF  CORRESPONDING  FLOW  AND  TEM¬ 
PERATURE  DATA. 

I  WILL  END  WITH  THE  LAST  YEAR  OF  CORRE¬ 
SPONDING  DATA  [year]. 

***  WARNING  14  *** 

YOUR  REQUESTED  MONTHS  WERE  BLANK. 

YOU  SHOULD  SPECIFY  THEM. 

I  WILL  PROCEED  WITH  THEM  ALL  TURNED  ON. 
[the  month  indicators  on  the  HABNET  input  file  are 
blank.] 

***  WARNING  16  *** 

THE  SEGMENT  LENGTH  FOR  SEGMENT: 
SEGMENT  NUMBER:  [number]  IS  ZERO. 

[the  segment  length  needs  to  be  specified  after  the  segment 
ID  in  the  HABNET  input  file.] 

***  WARNING  18  *** 

THE  MAXIMUM  NUMBER  OF  [number]  SEGMENTS 
HAS  BEEN  EXCEEDED. 


THE  FOLLOWING  SEGMENT:  [segment  ID]  WILL 
NOT  BE  INCLUDED  IN  PROCESSING. 

[There  are  too  many  segments  (current  limit  is  50)  in¬ 
cluded  in  processing  for  the  program  to  handle.] 

***  WARNING  20*** 

THE  FOLLOWING  SEGMENT:  [segment  ID]  IS  INVA¬ 
LID  OR  NOT  FOUND— IT  WILL  BE  EXCLUDED 
FROM  PROCESSING. 

***  WARNING  22*** 

THE  MAXIMUM  NUMBER  OF  [number]  LIFE 
STAGES  HAS  BEEN  EXCEEDED. 

THE  FOLLOWING  LIFE  STAGE:  [life  stage]  WILL 
NOT  BE  INCLUDED  IN  PROCESSING. 

[There  are  too  many  life  stages  (current  limit  is  10)  in¬ 
cluded  in  processing  for  the  program  to  handle.] 

***  WARNING  24  *** 

THE  FOLLOWING  LIFE  STAGE:  [life  stage]  IS  INVA¬ 
LID  OR  NOT  FOUND— IT  WILL  BE  EXCLUDED 
FROM  PROCESSING. 

***  WARNING  26*** 

NO  VALID  LIFE  STAGES  WERE  FOUND  IN  [filename]. 
PROCESSING  WILL  CONTINUE  WITHOUT  LIFE 
STAGES. 

Modified  Habitat-Versus-Flow  File 
(ZHAQFM)  Warnings 

***  WARNING  28*** 

AN  END-OF-RECORD  INDICATOR— ********** 
WAS  FOUND  IN  THE  Q-HA  FILE  WITHOUT  ANY 
DATA  BEFORE  IT.  YOU  MAY  WISH  TO  CHECK  THE 
DATA  ON  YOUR  Q-HA  FILE. 

[You  may  have  a  record  on  your  ZHAQFM  file  with  no 
points.] 

***  WARNING  30  *** 

SEGMENT:  [segment  ID]  WAS  FOUND  IN  YOUR 
HABITAT-VERSUS-FLOW  FILE,  BUT  NOT  IN  THE 
FLOW  DATA  FILE.  PROCESSING  WILL  SKIP  THIS 
SEGMENT. 

***  WARNING  32  *** 

BAD  SPECIES  LIFE  STAGE  [species^ife  stage]  FOUND 
IN  FILE.  I  WILL  TRY  TO  RECOVER. 

***  WARNING  34  *** 

EXPECTED  A  NEW  UFE  STAGE  BUT  FOUND  AN 
END  OF  FILE. 

I  WILL  TRY  TO  CONTINUE. 

[The  last  record  of  the  ZHAQFM  file  should  end  with 

**********  j 
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***  WARNING  36  *** 

TOO  MANY  UNIQUE  LIFE  STAGES  ENCOUN¬ 
TERED. 

I  CAN  ONLY  HANDLE  [number]. 

I  WILL  CONTINUE  WITH  WHAT  I  HAVE. 

[There  are  too  many  life  stages  (current  limit  is  10)  on  the 
ZHAQFM  file  for  the  program  to  handle.] 

***  WARNING  38  *** 

TOO  MANY  POINTS  IN  CURVE.  I  ONLY  HAVE 
ROOM  FOR  [number]. 

I  WILL  TRY  TO  RECOVER. 

[There  are  too  many  discharges  (current  limit  is  30)  in  your 
ZHAQFM  file  for  the  program  to  handle.] 

***  WARNING  40  *** 

FLOW  DATA  NOT  INCREASING. 

CHECK  DATA  FILE  FOR  [real  number]  IN  [species/life 
stage]. 

[The  discharges  on  the  ZHAQFM  file  must  be  in  ascending 
order  for  HABNET  to  work  properly.] 

***  WARNING  42*** 

THE  SEGMENT:  [segment  ID]  HAS  NO  FLOW-WUA 
DATA  POINTS. 

I  WILL  TRY  TO  CONTINUE. 

Monthly  Flow  File  (ZMTSM)  Warnings 

***  WARNING  44*** 

MONTHLY  FLOW  DATA  RLE  CONTAINS  [number] 
SEGMENTS. 

I  ONLY  HAVE  ROOM  FOR  [number].  I  WILL  CON¬ 
TINUE  WITH  THE  MAXIMUM  ALLOWED. 

[There  are  too  many  segments  (current  limit  is  50)  on  the 
ZMTSM  file  for  the  program  to  handle.] 

***  WARNING  46  ***— THE  SEGMENT: 

[segment  title] 

SEGMENT:  [segment  ID] 

IS  A  DITTO  SEGMENT  AND  IS  INDICATED  TO  BE 
COPIED  FROM  SEGMENT  ID:  [segment  ID]  WHICH 
HAS  NOT  BEEN  DEFINED. 

PROCESSING  WILL  IGNORE  THIS  SEGMENT. 

[A  ditto  segment  must  copy  data  from  a  previous  segment. 
A  ditto  segment  on  the  monthly  flow  file  does  not  match 
any  of  the  previous  segments.] 

Monthly  Temperature  File  (ZTEMP)  Warnings 

***  WARNING  48  *** 

TEMPERATURE  DATA  CONTAINS  [number]  SEG¬ 
MENTS. 

I  ONLY  HAVE  ROOM  FOR  [number].  I  WILL  CON¬ 
TINUE  WITH  THE  MAXIMUM  ALLOWED. 


[There  are  too  many  segments  (current  limit  is  50)  on  the 
ZTEMP  file  for  the  program  to  handle.] 

***  WARNING  50  ***— THE  SEGMENT: 

[segment  title] 
segment  ID:  [segment  ID] 

IS  A  DITTO  SEGMENT  AND  IS  INDICATED  TO  BE 
COPIED  FROM 

SEGMENT  ID:  [segment  ID]  WHICH  HAS  NOT  BEEN 
DEFINED. 

PROCESSING  WILL  IGNORE  THIS  SEGMENT. 

[A  ditto  segment  must  copy  data  from  a  previous  segment. 
A  ditto  segment  on  the  monthly  temperature  file  does  not 
match  any  of  the  previous  segments.] 

***  WARNING  52*** 

THE  SEGMENT:  [segment  ID]  WAS  ENCOUNTERED 
IN  YOUR  TEMPERATURE  DATA  FILE,  BUT  NOT 
FOUND  IN  YOUR  MONTHLY  FLOW  DATA  FILE. 
PROCESSING  SKIPS  THIS  SEGMENT  COM¬ 
PLETELY. 

***  WARNING  54  *** 

UNEXPECTED  END  FOUND  ON  TEMPERATURE 
DATA  ITLE:  [filename]  OR  OPTIONAL  TEMPERA¬ 
TURE  DATA  NOT  PROVIDED. 

ALL  HABITAT  WILL  BEUNCONDmONED  BYTEM¬ 
PERATURE. 

[This  warning  will  appear  if  you  are  not  using  temperature 
data,  or  if  there  is  incorrect  data  or  format  on  the  ZTEMP 
file.] 

Temperature  Suitability  File  (ZTSI)  Warnings 

***  WARNING  56  *** 

BAD  SPECIES  LIFE  STAGE  [species/life  stage]  FOUND 
IN  FILE.  I  WILL  TRY  TO  RECOVER. 

***  WARNING  58  *** 

LIFE  STAGE  [life  stage]  FOUND  IN  TEMPERATURE 
SUITABILITY  FILE  BUT  IT  WAS  NOT  FOUND  IN 
YOUR  Q-WUA  FILE:  [filename]. 

I  WILL  SKIP  THIS  RECORD. 

***  WARNING  60  *** 

EXPECTED  MIN,  AVG,  OR  MAX,  BUT  FOUND  [xxx] 
INSTEAD. 

REFERENCE  SET  TO  AVG. 

***  WARNING  62  *** 

TOO  MANY  POINTS  IN  CURVE.  I  ONLY  HAVE 
ROOM  FOR  [number]. 

I  WILL  TRY  TO  RECOVER. 

[There  are  too  many  points  (current  limit  is  15)  in  the 
temperature  suitability  curve  for  the  program  to  handle.] 
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***  WARNING  64*** 

TEMPERATURE  DATA  NOT  INCREASING.  CHECK 
DATA  FILE  FOR  [real  number]  IN  [segment], 

[The  temperature  data  in  the  temperature  suitability  file 
must  be  in  ascending  order  for  HABNET  to  work  prop¬ 
erly.] 

***  WARNING  66  *** 

SI  VALUE  NOT  BETWEEN  ZERO  AND  ONE.  CHECK 
DATA  FILE  FOR  [real  number]  COORDINATES 
SKIPPED.  I  WILL  TRY  TO  CONTINUE. 

[HABNET  uses  a  suitability  index  between  0  and  1.] 

***  WARNING  68  *** 

THIS  LIFE  STAGE  HAS  NO  DATA  POINTS.  I  WILL 
TRY  TO  CONTINUE. 

***  WARNING  70  *** 

UNEXPECTED  END  FOUND  ON  TEMPERATURE 
SUITABILITY  FILE:  [filename]  OR  OPTIONAL  TEM¬ 
PERATURE  SUITABILITY  DATA  NOT  PROVIDED. 
ALL  HABITAT  WILL  BE  UNCONDITIONED  BY  TEM¬ 
PERATURE. 

[This  warning  will  appear  if  you  are  not  using  temperature 
data  or  if  there  is  incorrect  data  or  format  on  the  ZTSI  file.] 

***  WARNING  72*** 

NOT  ABLE  TO  READ  LIFE  STAGES  FROM  TEM¬ 
PERATURE  SUITABILITY  FILE.  CHECK  TO  SEE  IF 
THE  TEMPERATURE  FORMAT  ON  THE  INPUT  FILE 
IS  CORRECT. 

[Either  there  is  an  error  in  the  ZTSI  file  or  the  wrong 
temperature  format  was  specified  (expecting  a  network 
temperature  suitability  index  file).] 

***  WARNING  74  *** 

NOT  ABLE  TO  READ  LIFE  STAGES  FROM  TEM¬ 
PERATURE  SUITABILITY  RLE.  CHECK  TO  SEE  IF 
THE  TEMPERATURE  FORMAT  ON  THE  INPUT  RLE 
IS  CORRECT. 

[Either  there  is  an  error  in  the  ZTSI  file  or  the  wrong 
temperature  format  was  specified  (expecting  a  RSHCRV 
file).] 

***  WARNING  76  *** 

ILLEGAL  DATA  ON  TEMPERATURE  SUITABILITY 
RLE. 

***  WARNING  78  *** 

THE  SPECIES/LIFE  STAGE:  [species/life  stage]  HAS 
NO  HABITAT  SUnABILITY  CURVE.  THE  DATA  FOR 
THIS  LIFE  STAGE  WILL  NOT  BE  TEMPERATURE 
CONDITIONED. 

[This  life  stage  was  not  included  on  your  ZTSI  file.] 

***  WARNING  80  *** 

FOR:  [specie^ife  stage]  AT  [segment  ID]  YEAR:  [xxxx] 


MONTH  #  [X]  TEMPERATURE  OF  [real  number]  IS 
BELOW  LOWEST  POINT  IN  T-SI  CURVE. 

***NO  SUITABILITY  INDEX  WILL  BE  CALCU¬ 
LATED.*** 

***YOUR  TIME  SERIES  DATA  MAY  BE  ERRONE¬ 
OUS.*** 

[The  month  (#)  displayed  is  the  order  of  the  month  in  the 
ZTEMP  file.  For  example,  if  the  first  month  of  data  in  the 
file  is  for  October,  month  #1 1  would  be  August.  If  the  first 
month  of  data  is  for  January,  then  month  #11  would  be 
November.] 

***  WARNING  82  *** 

FOR:  [species/life  stage]  AT  [segment  ID]  YEAR:  [xxxx] 
MONTH  #  [X]  TEMPERATURE  OF  [real  number]  IS 
ABOVE  HIGHEST  POINT  IN  T-SI  CURVE. 

***  NO  SUITABILITY  INDEX  WILL  BE  CALCU¬ 
LATED.*** 

***  YOUR  TIME  SERIES  DATA  MAY  BE  ERRONE¬ 
OUS.*** 

[The  month  (#)  displayed  is  the  order  of  the  month  in  the 
ZTEMP  file.  For  example,  if  the  first  month  of  data  in  the 
file  is  for  October,  month  #1 1  would  be  August.  If  the  first 
month  of  data  is  for  January,  then  month  #11  would  be 
November.] 

Warnings  for  problems  found  in  producing  the 
monthly  time  series  file  (ZMTS) 

***  WARNING  84  *** 

THE  LIFE  STAGE:  [life  stage]  WILL  NOT  BE  PRO¬ 
CESSED. 

THE  TIME  SERIES  DATA  THAT  WOULD  BE  PRa 
DUCED  WOULD  BE  PARTIALLY  TEMPERATURE  CON¬ 
DITIONED.  THIS  DATA  WOULD  BE  ERRONEOUS. 

***  WARNING  86  *** 

NO  TEMPERATURE  DATA  OR  TEMPERATURE 
DATA  INCOMPLETE. 

SEGMENT  NUMBER:  [number]  ID:  [segment  ID] 
TEMPERATURE  CONDITIONED  HABITAT  WILL 
NOT  BE  PRODUCED  FOR  THIS  SEGMENT. 

***  WARNING  88  *** 

FOR  [species/life  stage]  AT  [segment  ID]  FLOW  OF  [real 
number]  IS  BELOW  LOWEST  FLOW  IN  Q-HA  RELA¬ 
TIONSHIP 

[This  flow  is  below  the  lowest  flow  on  the  ZHAQFM 
file.] 

***  WARNING  90  *** 

FOR  [species/life  stage]  AT  [segment  ID]  FLOW  OF  [real 
number]  IS  GREATER  THAN  HIGHEST  FLOW  IN  Q- 
HA  CURVE. 

[This  flow  exceeds  the  highest  flow  on  the  ZHAQFM  file.] 
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***  WARNING  92  *** 

YEAR  =  [year]  MONTH  =  [month]  FLOW  OF  [real 
number] 

PROVIDED  AN  AREA  OF  [real  number].  THIS  IS  BE¬ 
LOW  YOUR  THRESHOLD  OF  [real  number]. 

[The  habitat  area  computed  for  this  flow,  time,  and  seg¬ 
ment  was  below  the  limit  given  on  the  ZHAQFM  file.] 

Fatal  Errors 

$$$  FATAL  ERROR  2  $$$ 

THERE  WAS  NO  DATA  FOR  REQUESTED  YEARS 
[...]OR[...’]. 

THERE  WERE  NO  CORRESPONDING  YEARS  OF 
FLOW  AND  TEMPERATURE  DATA. 

PROCESSING  CAN  NOT  CONTINUE. 

[The  data  files  do  not  contain  a  full  set  of  needed  data  for 
any  segment,  any  year.  Check  your  files  to  make  sure  the 
segment  ID’s  are  labeled  correctly.] 

$$$  FATAL  ERROR  4  $$$ 

NO  VALID  SEGMENTS  WERE  FOUND  IN  HABNET 
INPUT  FILE;  [filename].  PROCESSING  CANNOT 
CONTINUE. 

[Either  the  processing  indicator  characters  before  each 
segment  were  not  ‘  1  ’  (‘T’  or ‘t’  also  works)  or  the  segment 
ID’s  do  not  match  the  rest  of  the  data.] 

$$$  FATAL  ERROR  6  $$$ 

UNEXPECTED  END  FOUND  ON  HABNET  INPUT 
FILE:  [filename]. 

PROCESSING  CANNOT  CONTINUE. 

$$$  FATAL  ERROR  8  $$$ 

DID  NOT  GET  SUFFICIENT  DATA  FROM  LIFE 
STAGE  FILE  TO  CONTINUE  WITH  PROCESSING. 
[You  have  no  valid  life  stages  or  data  on  the  ZHAQFM 
file.] 


$$$  FATAL  ERROR  10  $$$ 

UNEXPECTED  END  FOUND  ON  MONTHLY  FLOW 
FILE:  [filename]. 

$$$  FATAL  ERROR  12  $$$ 

WRONG  DATA  FOUND  IN  MONTHLY  FLOW  FIIJS; 
[filename]. 

$$$  FATAL  ERROR  14  $$$ 

UNEXPECTED  PROBLEM  WITH  INTERNAL 
SCRATCH  FILE  GOSCR).  THE  MONTHLY  FLOW 
DATA  IS  READ  INTO  THIS  INDEXED  FILE. 

[You  should  not  get  this  error.  Either  there  is  an  undetected 
error  in  your  monthly  flow  data  or  there  is  an  error  in  the 
program.] 

$$$  FATAL  ERROR  16  $$$ 

UNEXPECTED  PROBLEM  WITH  INTERNAL  TEM¬ 
PERATURE  SCRATCH  HLE.  THE  TEMPERATURE 
DATA  IS  WRITTEN  TO  THIS  FILE. 

[You  should  not  get  this  error.  Either  there  is  an  imdetected 
error  in  your  monthly  flow  data  or  temperature  data,  or 
there  is  an  error  in  the  program.] 

$$$  FATAL  ERROR  18  $$$ 

UNEXPECTED  PROBLEM  WITH  INTERNAL  FLOW 
SCRATCH  FILE. 

THE  FLOW  DATA  IS  READ  FROM  THIS  FILE. 

[You  should  not  get  this  error.  Either  there  is  an  imdetected 
error  in  your  monthly  flow  data  or  there  is  an  error  in  the 
program.] 

$$$  FATAL  ERROR  20  $$$ 

PROBLEM  WITH  SCRATCH  FILE  IN  SUBROUTINE 
WRITHTS. 

[You  should  not  get  this  error.  Either  there  is  an  undetected 
error  in  your  monthly  flow  data  or  temperature  data,  or 
there  is  an  error  in  the  program.] 
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Introduction 

The  HABTS  program  creates  a  monthly  physical  habitat 
time  series  file  for  multiple  species  and  life  stages  using 
the  following  equation: 

HA,«PH(Q,), 

where 

Qt  is  the  average  or  median  flow  for  month  t, 

PH(  )  is  the  physical  habitat-versus-streamflow 
function,  and 

HAt  is  the  physical  habitat  for  month  t. 

The  program  calculates  monthly  habitat  values  at  the 
site,  using  linear  or  nonlinear  interpolation  for  each  species 
and  life  stage. 

Two  sets  of  relations  are  used  as  input  to  HABTS.  The 
first  is  the  habitat  area-versus-streamflow  flow  relation  for 
the  species  and  life  stages  of  interest  (ZHAQF  file).  Up  to 
four  species,  each  with  up  to  five  life  stages,  can  be 
considered  in  each  program  run.  This  habitat  area-versus- 
streamflow  file  (ZHAQF)  is  generated  by  the  habitat  simu¬ 
lation  programs  in  the  physical  habitat  simulation  system 
(PHABSIM)  or  can  be  created  using  the  CRHAQF  pro¬ 
gram.  A  maximum  of  30  habitat  area-versus-flow  pairs  is 
acceptable.  The  flows  must  be  in  ascending  order. 

The  second  set  of  relations  used  as  input  to  HABTS  is 
flow  versus  time,  in  months,  at  the  site  of  interest 
(ZMONQ  file).  This  file  can  be  in  either  USGS  or  NWDC 
format.  The  maximum  permissible  number  of  flow- 
versus-time  data  pairs  is  1,200  (100  years  of  data).  The 
ZMONQ  file  can  be  created  by  the  QIN  program,  or  the 
DQTOMQ  program  could  be  run  to  convert  a  daily  stream- 
flow  file  to  a  monthly  streamflow  file  in  NWDC  format. 

Running  HABTS 

RHABTS,  ZHAQF,  ZMONQ,  ZMTS,  ZOUT 

ZHAQF  *  Habitat  area-versus-streamflow  file  (in¬ 
put). 

ZMONQ  “  Monthly  streamflow  file  in  USGS  or 
NWDC  format  (input). 

ZMTS  =  Monthly  habitat  time  series  file  with 
multiple  records  in  the  same  format  as 
the  ZMONQ  input  file  (output). 

ZOUT  =  HABTS  results  (output). 


ENTER  RECORD  NAME  (5  CHAR? 


On  the  ZMTS  output  file,  the  data  for  each  specie^life 
stage  is  written  as  a  separate  section,  terminated  by 
#EOR,  and  is  preceded  by  a  header-line  containing  a 
user-designated  label  and  a  sequential  numbering  system. 

For  example,  if  CLASS  is  entered  here  as  the  record 
name,  the  very  top  line  on  the  ZMTS  file  will  contain 
CLASSAl.  Following  this  line  will  be  two  title  lines, 
then  the  USGS  formatted  habitat  data  for  the  first  spe¬ 
cies,  first  life  stage.  Next  there  will  be  a  line  containing 
CLASSA2,  followed  by  two  title  lines  and  the  data  for 
the  first  species,  second  life  stage.  Following  all  life 
stages  of  the  first  species,  the  line  will  contain  CLASSBl 
for  the  second  species,  first  life  stage,  and  so  on.  In  other 
words,  each  species  will  begin  a  new  letter  (A-D)  and 
each  life  stage  will  begin  a  new  number  (1-5). 

IeNTER  I  FOR  LINEAR  INTERPOLATION^  2  FOR  INONLTNEAR. 


If  2  is  entered  for  NONLINEAR,  the  following  prompt 
will  appear. 

■ENTER  I  FOR  LINEAR  TAILS,  2  FOR  NONLINEAR . 


Flow  values  in  the  flow-versus-time  series  that  are 
smaller  than  lowest  flows  or  greater  than  highest  flows 
in  the  flow-versus-habitat  relation  are  considered  tail 
flows.  Habitat  values  for  these  tail  flows  must  be  ex¬ 
trapolated,  as  described  in  the  “HABTS  Calculations” 
section.  Indicate  whether  the  extrapolation  should  be 
linear  or  nonlinear.  Do  not  use  nonlinear  extrapolation 
for  any  serious  analysis  unless  you  know  what  you  are 
doing.  This  program  could  give  negative  or  wildly  irra¬ 
tional  results  for  nonlinear  extrapolation,  and  you  should 
know  how  to  handle  this  problem. 


ENTER  SCALINO  FACTOR  FOR  Att  HABITAT  TIME  SERIES  OUTPUT  VALUES, 
OR  1  TO  LEAVE  VALUES  IN  ORIGINAL  UNITS.  ' 


This  is  useful  for  creating  total  habitat  values  (ft^)  from 
areas  that  were  originally  in  ft^/ 1,000  ft  of  stream.  For 
example,  if  your  segments  were  10  miles  long,  you  could 
multiply  the  habitat  values  by  10  *  5.28  (or  52.8)  to 
produce  total  habitat  in  square  feet. 


THIS  MAY  TAKE  A  WHILE  .  .  . 


The  cursor  will  be  at  the  end  of  this  message.  This  is  an 
indication  that  the  program  is  making  calculations.  These 
calculations  may  take  several  minutes  to  compute.  Do  not 
reset  the  machine;  wait  until  the  DOS  prompt  returns. 
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The  output  file  generated  by  HABTS  is  similar  to  the 
output  file  generated  by  HABTD  (Chapter  6). 

HABTS  Calculations 

Each  species/life  stage  is  processed  separately. 

Habitat  Factors.  The  first  calculations  performed  by 
program  HABTS  involve  habitat  area-versus-flow  data 
only.  For  linear  interpolation,  let  /i  -  the  number  of  habitat 
area-versus-flow  pairs  provided  as  input  for  a  given  spe¬ 
cies/life  stage.  Then, 

'  Q,  +  l-Q/ 

where 

i-=  1,2,3,.../!, 

H/  =  habitat  area  for  pair  i, 

Qi  *=  flow  for  pair  i,  and 

Bi  “  habitat  factor  (slope)  B  for  pair  i . 

There  will  be  a  total  of  n  -  1  habitat  factor  B’s  calcu¬ 
lated. 

Then, 

A/  =  H/-(B/*Q0, 

where 

i“  1,2,3, .../!, 

H|  =  habitat  area  pair  /, 

Q/=  flow  for  pair !, 

B,-  =  habitat  factor  B  for  pair  /,  and 
Ai  habitat  factor  (intercept)  A  for  pair  i. 

There  will  be  a  total  of  /i  -  1  habitat  factor  As  calculated. 

These  habitat  factors  [A(l  through  n  “  1)  and  B(1  through 
n  -  1)]  will  be  used  later  in  calculating  the  monthly  habitat 
area  at  the  specific  site.  For  nonlinear  interpolation,  habitat 
factors  Ai,  B/,  Q,  and  D/  are  Lagrangian  parameters  (see 
Milne  1 949).  The  flows,  habitat  areas,  and  habitat  factors  are 
all  written  to  ZOUT  in  a  tabular  format. 

Comparison  of  Flows.  The  HABTS  program  then  com¬ 
pares  all  the  flows  provided  in  the  flow-versus-time  pairs 
with  the  flow-versus-habitat  area  pairs.  It  will  flag  any 
flows  of  the  former  set  that  are  greater  than  the  highest 
flow  or  less  than  the  lowest  flow  of  the  latter  set.  Warnings 
of  these  flagged  data  are  written  to  ZOUT.  The  program 
will  proceed  even  if  such  values  are  found. 

Available  Monthly  Physical  Habitat.  Using  the  flows 
provided  on  the  flow  versus  time  input  file,  and  the  habitat 
factors  calculated  (see  Habitat  Factors)^  a  habitat  value  for 
each  month  of  each  year  for  which  flow  versus  time  was 


provided  is  calculated.  The  following  equation  is  used  for 
linear  interpolation: 

H  =  A,  +  (B,*Q) 

where 

H  *  the  physical  habitat  available  at  the  site 
for  the  given  month  and  year, 

A|  *  habitat  factor  (calculated  in  Habitat  Fac¬ 
tors  section)  that  corresponds  to  habitat 
factor  Bi  in  this  equation, 

Bi »  habitat  factor  (calculated  in  Habitat  Fac¬ 
tors  section)  that  applies  to  the  flow  in¬ 
terval  in  which  Q  resides  and  the  given 
species  and  life  stage,  and 

Q  =  the  flow  for  the  given  month  and  year  at 
the  site  of  interest. 

For  nonlinear  interpolation,  the  following  formula  is  used: 

H  -  (Ai  *  Q3)  +  (B;  *  Q2)  +  (Ci  *  Q)  +  D/, 

where 

H  =  the  physical  habitat  available  at  the  site 
for  the  given  month  and  year, 

Ai,  Bi,  Q,  Di  *=  Lagrangian  parameters,  as  discussed 
in  Habitat  Factors  section,  and 

Q  =  the  flow  for  the  given  month  and  year  at 
the  site  of  interest. 

This  calculation  is  repeated  for  each  flow-veisus-time  data 
set. 

When  linear  interpolation  of  tails  is  selected,  the  flow 
values  flagged  in  the  Comparison  of  Flows  section  are 
processed  by  extrapolating  from  the  two  highest  or  two 
lowest  flow  values  provided  in  the  flow-versus-habitat  rela¬ 
tion. 

Nonlinear  interpolation  of  tails  is  performed  using  the 
following  equation: 

H  =  (B,*Q2)  +  (Q*Q)  +  Di 

where 

H  =  the  physical  habitat  available  at  the  site 
for  the  given  month  and  year, 

B|,  Ci,  Di  ^  Lagrangian  parameters,  as  discussed  in 
the  Habitat  Factors  section,  and 

Q  =  the  flow  for  the  given  month  and  year  at 
the  site  of  interest. 

Negative  values  are  not  set  equal  to  0.  The  user 
should  be  aware  of  this  process,  and  interpret  the  results 
accordingly. 
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Introduction 

The  HQFMON  program  adds  month  indicators  and 
minimum  habitat  values  to  a  habitat  area-versus- 
streamflow  (ZHAQF)  file.  An  extra  title  line  and  segment 
ID  line  can  also  be  added  if  they  were  not  previously 
entered  with  an  editor.  The  resulting  file  is  used  as  input 
to  the  HABNET  program. 

Month  indicators  inform  the  HABNET  program  what 
months  to  process  for  each  species  and  life  stage.  The 
minimum  habitat  value  is  a  habitat  threshold.  Any  value 
below  the  value  entered  will  produce  a  warning  message 
if  the  population's  usable  area  falls  below  it  in  any  month. 

Figure  7.7  contains  a  partial  modiHed  monthly  flow  time 
series  file  in  USGS  format  (ZHAQFM)  created  by  the 
HQFMON  program.  A  complete  ZHAQFM  file  is  in¬ 
cluded  in  your  sample  data  sets.  Appendix  A  contains  the 
file  format  for  a  ZHAQFM  file. 

Running  HQFMON 

RHQFMON,  ZHAQF,  ZHAQFM 

ZHAQF  =  Habitat  area-versus-streamflow  file  (in¬ 
put). 

ZHAQFM  *  Habitat  area-versus-streamflow  file  with 
month  indicators  and  minimum  habitat 
values  (output).  An  extra  title  line  and 
segment  ID  line  can  also  be  added  if  they 
were  not  previously  entered  with  an  edi¬ 
tor.  This  file  is  used  as  input  to  the  HAB¬ 
NET  program. 


ENTER  0  TO  ADP  A  TITLE  LINE  TO  EACH  LIFE  STAGE 
1  TO  ADD  A  TITLE  LINE  TO  RECORD  ONLY 
_ 2  TO  NOT  ADD  OR  CHANCE  TITLE  LINES  . 


Extra  title  lines  may  be  entered.  These  extra  title  lines 
would  be  the  third  line  in  the  file  and  the  first  line  in  each 
species/life  stage  record — ^records  are  separated  by  at 
least  10  asterisks  (**********).  These  title  lines  are  not 
required  by  the  HABNET  program,  but  they  do  help 
label  the  information.  Other  PHABSIM  applications 
may  require  that  these  title  lines  be  deleted. 

Entering  0  allows  you  to  enter  separate  title  lines  for 
every  life  stage  in  the  file.  The  input  ZHAQF  file  may 
either  have  records  grouped  by  life  stage  or  may  be 
grouped  by  species  with  multiple  life  stages  in  each 


record.  Remember,  records  are  separated  by  at  least  10 
asterisks  (**********), 

Entering  1  allows  you  to  have  the  same  title  line 
entered  for  all  life  stages  for  a  species  when  the  records 
in  the  input  file  were  grouped  by  species  with  multiple 
life  stages. 

BNTEft  0  To  ADD  A  SfiOMEaW  tt>  tO  MCH  LIFE  5TA6e 

1  TO  ADD  A  SEGMEWr  ID  TO  BACH  ABCCRD  ONLY 

2  IF  THE  FILE  ALREADY  HAS  SEGMENT  ID* 5  . 


A  segment  ID  line  is  required  by  the  HABNET  pro¬ 
gram.  It  follows  the  extra  title  line  in  each  record  or  is 
the  first  line  in  each  record  if  extra  title  lines  were  not 
added.  The  segment  ID  numbers  have  to  match  exactly 
with  the  segments  ID  numbers  read  from  the  gaging 
station  data  file  (ZMTSM),  the  HABNET  input  file 
(ZHABIN),  and  the  temperature  time  series  or  tempera- 
ture-versus-flow  relation  file  (ZTEMP).  Once  again, 
other  PHABSIM  applications  may  require  that  these 
lines  be  deleted. 

Entering  0  allows  you  to  enter  separate  segment  ID 
numbers  for  every  life  stage  in  the  file.  Remember,  the 
input  ZHAQF  file  may  either  have  records  grouped  by 
life  stage  or  grouped  by  species  with  multiple  life  stages 
in  each  record.  Remember,  records  are  separated  by  at 
least  10  asterisks  (******★**★), 

Entering  1  allows  you  to  have  the  same  segment  ID 
number  entered  for  qU  life  stages  for  a  species  when  the 
records  in  the  input  file  were  grouped  by  species  with 
multiple  life  stages. 


HABNET  ALLOWS  YOU  TO  INDICATE  THE  APPLICABLE  MONTHS 
:TO  PROCESS  FOR  EACH  SPECIES  AND  LIFE  STAGE  THE  ZHAQF  FILE, 

A  U'  INDICATES  THAT  THE  MCWTH  IS  TO  BE  PROCESSED, 

A  *0*  INDICATES  THAT  THE  MONTH  IS  NOT  TO  BE  PROCESSED. 

ENTER  0  IF  YOU  WISH  TO  ADD  MONTH  INDICATORS  FOR 
EACH  LIFE  STAGE 

1  IF  YOU  WISH  TO  ADD  MONTH  INDICATORS  FOR 
EACH  RECORD  ON  THE  ORIGINAL  FILE 

2  IF  YOb  WISH  TO  ADD  THE  SAME  MONTH  INDICATORS 

FOR  EVERY  LIFE  STAGE  IN  THE  DATA  SET. _ 

The  processing  of  each  month  is  determined  from  both 
the  HABNET  input  file  (ZHABIN)  and  the  habitat- versus- 
flow  file  with  month  indicators  (ZHAQFM).  Both  month 
indicators  must  be  “on’*  to  be  processed.  Some  examples 
follow: 

If  month  indicator  is  1  in  ZHABIN  and  1  in  ZHAQFM, 
then  that  month  will  be  processed  for  that  species,  life 
stage,  and  location. 
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If  month  indicator  is  1  in  ZHABIN  and  0  in  ZHAQFM, 
that  month  will  not  be  processed  for  that  species,  life 
stage,  and  location. 

If  month  indicator  is  0  in  ZHABIN  and  1  in  ZHAQFM, 
that  month  will  not  be  processed  for  that  species,  life 
stage,  and  location. 

If  month  indicator  is  0  in  ZHABIN  and  0  in  2aiAQFM, 
that  month  will  not  be  processed  for  that  species,  life 
stage,  and  location. 

Entering  0  allows  you  to  enter  separate  month  indica¬ 
tors  for  every  life  stage  in  the  file. 

Entering  1  allows  you  to  have  the  same  month  indica¬ 
tors  entered  for  a//  life  stages  for  a  species  when  the  records 
in  the  input  file  were  grouped  by  species  with  multiple  life 
stages. 

Entering  2  enters  the  same  month  indicators  for  every 
life  stage  of  every  species  in  the  original  data  set. 

If  2  is  entered: 

Eifrla!  1  OK  0  kach  AtWJcABte  MotfrH  roR  ail  records 

AND  LIFE  STASES. 

{EX^,  110000000011) _ _ _ - _ - 


Note:  The  months  should  be  in  the  same  format  for  all 
input  files  (ZHABIN,  ZMTSM,  ZHAQFM,  and 
ZTEMP) — that  is,  all  in  water  years,  calendar 
years,  and  so  forth. 

TO  EACH  I.IPE  STAGE  OK  THE  XHAQfW  PILE.  KAl^HET  COMPARES 
THE  AREA  THAT  IT  CALCULATES  WtTH  THE  VALUE  CtVEH  m> 

GIVES  A  WARMJSG  IP  THE  CALCULATED  HABITAT  t$ 

|ip|i|iiiw|||||||||||||||||||i^ 

ENTER  Q  IP  YOU  WISH  TO  ADO  MINIMUM  HABITAT  VALUES 
m  EACH  LIFE  STAGE 

1  IF  YOU  WISH  TO  ADD  MINIMUM  HABITAT  VALUES 
FOR  EACH  RECORD  ON  THE  ORIGINAL  FILE 

2  IP  YOU  WISH  TO  ADD  THE  SAME  MINIMUM  HABITAT 
_ VALUE  FOR  EVERY  LIFE  STAGE  IN  THE  DATA  SET. 

The  minimum  habitat  value  is  a  habitat  threshold.  Any 
value  below  the  value  entered  will  produce  a  warning 
message  if  the  population’s  usable  area  falls  below  it  in 
any  month. 

Entering  0  allows  you  to  enter  separate  minimum  habi¬ 
tat  values  for  every  life  stage  in  the  file. 

Entering  1  allows  you  to  have  the  same  minimum 
habitat  values  entered  for  all  life  stages  for  a  species  when 


CACHE  LA  POUDRE  RIVER  FLOW  VS.  HABITAT  (WUA  SQ .  FT  PER  FT.)  FUNCTIONS 
SECOND  MAIN  TITLE  LINE 

POUDRE  RIVER  SEGMENT  1  SITE  5  (Extra  title  line) 

SEG  1 . 5  (Segment  ID  line) 

brown  111111111111  0.0 

DISCHARGE  ADULT  (Month  Indicators)  (Habitat  Threshold) 

0.00  0. 

25.00  13000. 

50.00  16500. 

100.00  19400. 

200.00  19000. 

300.00  15000. 

500.00  10000. 

700.00  7900. 

900.00  6400. 

1000.00  5800. 

2000.00  4100. 

3000.00  4000. 

5000.00  4000.  Arbitrarily  extended 


POUDRE  RIVER  SEGMENT  1  SITE  5 
SEG  1.5 

brown  111111111111  0.0 

DISCHARGE  JUVENILE 

0.00  0. 

25.00  15000. 

50.00  21000. 

100.00  28000. 

200.00  25700. 

300.00  20200. 

500.00  14200. 

700.00  10200. 

900.00  7400. 

1000.00  7000. 

2000.00  4100. 

3000.00  3500. 

5000.00  3500.  Arbitrarily  extended 


Fig.  7.7.  Sample  ZHAQFM  file  used  as  input  to  HABNET. 
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the  records  in  the  input  file  were  grouped  by  species  with 
multiple  life  stages. 

Entering  2  enters  the  same  minimum  habitat  value  for 
every  life  stage  of  every  species  in  the  original  data  set. 

If  2  is  entered: 


EtJTER  THB  fOVBmt  (RBO  HAO)  VUm  fOR  AtX 

RECORDS  AND  LIFE  STAGES i 


The  following  prompts  will  appear  for  each  species  and 
life  stage  record  in  the  input  file  (ZHAQI^,  depending  on 
what  options  were  chosen: 


EtflER  A  NEW  TITUS  'UKE  FOR  THIS  UtFRSIAGE  lot  REOCfRD)  (SO  0«RS  MAX)  ? 
ENltR  A  SEGMENT  ID  {S  CHARS  MAX)  FoR  THIS  tIPESTAGE  (or  RECCED)  s 


Remember,  the  segment  ID  numbers  have  to  match 
exactly  with  the  segments  ID  numbers  read  from  the 


gaging  station  data  file  (ZMTSM),  the  HABNET  input 
file  (ZHABIN),  and  the  temperature  time  series  or 
temperature-versus-flow  relation  file  (27rEMP). 


a»TER  1  OR  0  FOR  EACH  APFtiCA&LE  MONIH  FOR  THIS  tlRE  StAOE 
(or  RECORD); 


Remember,  the  processing  of  each  month  is  deter¬ 
mined  from  both  the  HABNET  input  file  (ZHABIN)  and 
the  habitat-versus-flow  file  with  month  indicators 
(ZHAQFM).  Both  month  indicators  must  be  “on”  to  be 
processed.  The  months  should  be  in  the  same  format  for 
all  input  files  (ZHABIN,  ZMTSM,  ZHAQFM,  and 
ZTEMP) — that  is,  all  in  water  years,  calendar  years,  and 
so  forth. 


ENTER  THE  MINIMIW  HABITAT  (RED  FLAG)  VALUE  FOR  THIS 
LIFE  STAGE (or  RECORD) t 
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QTEM  Program 


Introduction 


Running  QTEM 


The  QTEM  program  generates  a  temperature-versus-flow 
equation  (ZTEMP)  file  for  use  with  the  HABNET  program. 
This  file  is  a  free-formatted  file  where  the  user  supplies 
parameters  so  that  temperature  is  calculated  as  a  function  of 
flow  for  each  of  the  1 2  time  steps  per  year  at  each  geographic 
location.  The  formulation  is 

Ti-a,  +  fc;logQ,  +  c,Q^ 

where 

T/  =“  calculated  temperature  for  time  step  /, 


RQTEM,  ZTEMP 

ZTEMP  “  free-formatted  flow-versus-temperature 
equation  file  (output). 

BKTER  3  TITLE  LIWES  MeO  CR\RS  MAX  EACH)  ; _ 

These  title  lines  are  for  identification  of  the  data. 

ENTER  A  SEGMENT  ID  NUMBER! 


a/,  hi,  ci,  di  -  empirically  derived  coefficients  for  time 
step  i,  and 

log  Q;  “  natural  log  (base  e)  or  discharge  Q  for 
time  step  i 

The  B-coefficient  term  will  only  be  valid  down  to  flows 
of  1  cfs  or  1  cms.  If  flows  are  below  1,  the  whole  term  will 
drop  out  of  the  temperature  calculation  equation.  In  other 
words,  we  really  have  a  set  of  equations  that  looks  like  this: 

IfQ>l, 

T  =  a  +  ^  ln(Q)  +  c  Q^. 


IfQ<l, 


T  =  a  +  c  0^. 


Type  INFOTQ  for  on-line  information  on  the  format  of 
this  file.  Figure  7.8  contains  a  sample  free-formatted 
ZTEMP  file  created  by  the  QTEM  program. 

The  ZTEMP  file  also  can  contain  temperature  data  in 
uses  or  NWDC  format.  This  file  is  in  the  same  format  as 
the  2MrSM  file  except  that  it  contains  temperature  data 
instead  of  flow  data.  Refer  to  Appendix  A  for  the  format  of 
the  ZTEMP  file. 


The  segment  ID  numbers  have  to  match  exactly  with  the 
segments  ID  numbers  read  from  the  gaging  station  data  file 
(ZMTSM),  the  HABNET  input  file  (ZHABIN),  and  the 
habitat  area-versus-streamflow  file  (ZHAQFM). 


THE  HABNET  PROGRAM  USES  THE  FOLLOWING  EQUATIONS; 


If  <y  kl, 

::Temperature  *  A  >  B  *  C 


If  g  <  1, 

Temperature  *A+C*q**D 
where  q  ^  diacharge. 


ENTER  A,  B,  C,  AND  0  FOR  SEGMEOT  •  ID  number)  i 

BY  MONTH! 


Note:  The  months  should  be  in  the  same  format  for  all 
input  files  (ZHABIN,  ZMTS,  ZHAQFM,  and 
ZTEMP) — that  is,  all  in  water  years,  calendar 
years,  and  so  forth. 


Data  may  be  entered  using  commas  or  spaces  as  separa¬ 
tors  or  entered  one  or  more  per  line. 


ENTER  .  ...1  TO  ADD  ANOTHER  SEGMENT 
0  TO  EXIT. 


Temperature  (F)  versus  flow  (cfs)  file  for  Poudre  River  Network 
Water  year  organization 

Data  from  SSTEMP  approximations  (Temperature  predictions  in  Degrees  F) 
TQ 

SEG  1.5 


1 

40.660 

1.470 

0.000 

0.000 

2 

22.920 

3.700 

0.000 

0.000 

3 

22.300 

3.510 

0.000 

0.000 

4 

22 . 160 

3.470 

0 . 000 

0 . 000 

5 

22.690 

3.630 

0.000 

0 . 000 

6 

27 .86  0 

3.080 

0.000 

0.000 

7 

37 .620 

1.850 

0.000 

0.000 

8 

58.000 

•0.610 

0.000 

0.000 

9 

70.230 

-2.000 

0.000 

0.000 

10 

74 .600 

-2.490 

0.000 

0.000 

11 

69.320 

-1.900 

0.000 

0.000 

12 

55.080 

-0.270 

0.000 

0.000 

Fig.  7.8.  Sample  ZTEMP  file  created  by  the  QTEM  program. 
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Chapter  8. 

Manipulation;  Analysis,  and  Display  of  Monthly  Time 
Series  Data 


Introduction 

The  monthly  streamflow  and  physical  habitat  values  in 
themselves  tell  us  little  unless  we  analyze  and  display  the 
results.  The  programs  presented  in  Chapter  8  am  used  to 
manipulate,  analyze,  and  display  the  monthly  time  series 
data  (Fig.  8. 1).  In  many  situations,  this  should  be  considered 
an  intermediate  step  before  proceeding  to  the  generation  of 
an  annual  time  series. 

In  the  absence  of  good,  long-term  biological  data  on 
population  sizes,  biomass,  survivorship,  fecundity,  and  emi¬ 
gration-immigration,  we  must  use  some  measure  of  habitat 
as  an  index  to  measure  alternative  operations  plans.  In  other 
words,  we  need  some  measure  of  system  performance  to 
know  whether  we  are  getting  better  or  worse  than  the 
existing  condition. 

Several  alternative  indices  have  been  proposed  for  this 
task,  each  of  which  has  a  different  utility  and  none  of 
which  appears  to  have  universal  applicability.  Each  must  be 
qualified  as  to  appropriate  time  of  year,  time  step,  spatial 
extent,  and  unit  measure  (e.g.,  HA,  WUA,  degree  days).  In 
this  discussion,  we  will  confine  ourselves  to  consider 
indices  of  the  time  series  of  habitat  values.  The  alternative 
indices  are  each  meant  to  characterize  the  effective  habitat 
and  are  as  follows: 

a.  Average, 

b.  Median, 

c.  Index-A, 

d.  Index-B, 

e.  Index-C, 

f.  Minimum, 

g.  Maximum, 

h.  Some  fixed  exceedence  statistic,  and 

i.  Some  combination. 

The  average  value  is  the  intuitively  obvious  choice.  It 
provides  a  good  integration  of  all  events  but  may  mask  the 
extremes  that  really  control  a  population.  For  example, 
increasing  the  value  of  habitat  highs  and  decreasing  habitat 
lows  may  result  in  the  same  average  value.  If  it  were  the 
lows  that  were  thought  to  be  controlling,  the  average  is  not 
a  good  measure  of  performance.  Similarly,  for  a  hydro- 
peaking  situation,  habitat  values  may  swing  dramatically 
from  high  to  low — the  average  may  never  really  occur  and 
thus  may  be  a  misleading  statistic. 


The  median  may  often  be  a  better  measure  of  central 
tendency  than  the  average,  with  50%  of  the  events  being  of 
greater  value  and  50%  of  lesser  value.  The  median  is  not  as 
sensitive  to  high  or  low  exh'emes;  however,  like  the  average, 
the  median  may  not  be  expressive  of  habitat  bottlenecks  and 
may  never  actually  occur. 

Index-A  is  the  average  of  the  habitat  values  between  the 
50%  and  90%  exceedence  levels — that  is,  index-A  reflects 
the  majority  of  the  lowest  habitat  events.  If  these  events 
are  thought  to  limit  the  population,  index-A  might  be  a 
good  measure  of  habitat  value.  However,  if  a  species  is 
thought  to  take  advantage  of  high  habitat  values  through 
growth  or  reproductive  success,  this  index  may  not  be  a 
good  measure. 

Index-B  is  similar  to  what  is  called  a  trimmed  mean.  It  is 
the  average  of  the  values  between  the  10%  and  90%  ex¬ 
ceedence  levels.  Similar  to  the  average,  index-B  only  omits 
the  very  highest  and  very  lowest  habitat  events.  Index-B  may 
be  a  gcxxi  replacement  for  the  average,  but  probably  has  little 
utility  beyond  that. 

Index-C  is  a  user-defined  exceedence  category.  This 
index  may  be  useful  if  the  exceedence  values  described  by 
index-A  and  index-B  are  irrelevant  to  your  application  or 
do  not  cover  the  percentages  of  interest.  For  example,  if 
the  events  in  the  90-100%  exceedence  category  are 
thought  to  be  important  population  limiting  events,  then 
you  may  wish  to  define  index-C  as  coveiing  the  90-100% 
exceedence  category. 

Fixed  exceedence  levels  can  make  a  lot  of  sense  in  some 
cases.  For  example,  the  90%  exceexience  level  is  a  good 
representation  of  the  lowest  habitat  events,  but  discounts 
those  10%  that  will  occasionally  occur.  Similar  to  the  mini¬ 
mum,  the  90%  value  typifies  habitat  minima.  A  variation  on 
this  theme  is  the  use  of  the  recurrence  interval  for  habitat 
peaks  or  troughs. 

Tlie  minimum  is  another  intuitive  measure.  If  habitat 
bottlenecks  are  thought  to  be  caused  by  habitat  minima,  this 
is  the  obvious  choice.  Often  the  minimum  is  used  on  an 
annual  basis,  followed  by  a  duration  analysis  of  this  mini¬ 
mum  series.  Beware  of  situations  where  the  annual  mini¬ 
mum  value  does  not  change  but  its  frequency  increases. 

The  maximum  is  the  opposite  of  the  minimum.  This 
index  may  be  appropriate  for  something  like  spawning  if 
the  species  is  thought  to  take  advantage  of  good  spawning 
conditions  during  some  period.  For  species  that  require  a 


140 


Biological  Report  90  (16) 


PLOTTING  HABITAT  TIME  SERIES  AND  DURATION 


Fig.  8.1.  Plotting  habitat  time  series  and 
duration. 


HABITAT  HABITAT  HABITAT 
(Oct)  (Nov)  (Dec) 


HABITAT 

(annual) 


m. 


UJ  I - 

HABITAT 


(grouped  by  months) 


good  year  class  only  every  few  years  to  be  successful,  the 
maximum  value  may  be  a  good  measure. 

Combinations  of  indices  may  be  appropriate  in  some 
cases.  In  fact,  no  matter  what  index  is  used,  a  supporting 
rationale  must  be  present.  It  might  be  worthwhile  to  look  at 
a  brief  example  of  comparison,  not  so  much  for  what  any 
given  study  results  should  look  like,  but  just  to  reinforce  the 
concepts.  Figure  8.2  is  a  habitat  time  series  baseline-versus- 
operation  alternative  1;  Fig.  8.3  displays  the  corresponding 
habitat  duration  curve;  and  Fig.  8.4  compares  several  of  the 
habitat  indices  for  the  same  data. 


In  an  actual  time  series  analysis,  one  would  compare  the 
habitat  index  for  the  baseline  condition  with  the  habitat 
indices  for  each  alternative  operational  scenario;  compute 
and  record  amounts  of  habitat  gained  or  lost  with  each 
alternative;  postulate  causes  (e.g.,  high  flows,  low  flows, 
fluctuating  flows,  habitat  loss  to  inundation)  of  unaccept¬ 
able  change  in  habitat  index;  and  recommend  alternatives 
and  request  analysis  of  your  alternatives  or  conduct  your 
own  analysis. 


Habitat  Time  Series 


Time 


Manipulation,  Analysis,  and  Display  of  Monthly  Time  Series  Data 
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Habitat  Duration  Analysis 


Fig.  83.  Habitat  duration  curve — 
baseline-versus-operation 
alternative  1. 


Comparison  of  Habitat  Indices 


Average  Maximum  Minimum 


0  Baseline 
■  Operation  1 


Median  Index  A  Index  B  90% 


Fig.  8,4.  Comparison  of  several  of  the  ha¬ 
bitat  indices  for  the  same  data. 
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Program  Batcl^Procedure 
Name  Filename 

CHGFMT  RCHGFMT 


COMMTS  RCOMMTS 


MULMTS  RMULMTS 


SELMTS  RSELMTS 


Manipulating  Monthly  Time  Series  Data 


Fiincticai 

Monthly 
time  series 
manipulaticm 


Mcxithly 
time  series 
manipulation 


Monthly 
time  series 
manipulation 


Monthly 
time  series 
manipulation 


_ _ Rogram  Description _ 

Changes  a  USGS  format  file  to  a  NWDC  format  file  or  vice  versa. 

RCHGFMT,  ZMTS,  ZMTSN 

ZMTS  *  Monthly  time  series  file  in  USGS  or  NWDC  format;  can 
be  multirecord  file  (input). 

ZMTSN  =  New  monthly  time  series  file  in  NWDC  or  USGS  for¬ 
mat;  will  be  multirecord  if  ZMTS  is  (output). 

Sums  two  USGS  formatted  files  mcaith  by  month  with  given  weights. 

RCOMMTS,  ZMTSl,  ZMTS2,  ZMTSN 

ZMTSl  =  Monthly  time  series  file  in  USGS  format;  can  be  multi- 
record  (input). 

ZMTS2  «  Monthly  time  series  file  in  USGS  format;  can  be  multi- 
record  (input). 

ZMTSN  =  Combined  monthly  time  series  file  in  USGS  format 
(output). 

Multiplies  all  the  data  in  a  monthly  time  series  file  in  USGS  or 
NWDC  format  by  a  constant.  The  output  file  is  in  the  same  format  as 
the  input  file. 

RMULMTS,  ZMTS,  ZMTSN 

ZMTS  =  Monthly  time  series  file;  can  be  multiiecoid  file  (input). 

ZMTSN  =  New  monthly  time  series  file  alter  multiplication  (output). 

Allows  selection  of  individual  months  or  groups  of  mrniths  from  two 
or  more  monthly  time  series  data  files  to  create  a  single,  composite 
monthly  time  series  file. 

RSELMTS,  ZMTSN,  ZMTS 

ZMTSN  =  New  monthly  time  series  file  in  the  same  format  as  the 
input  files  (output). 

ZMTS  ~  A  base  monthly  time  series  file  to  be  used  as  a  building 
block;  can  be  multirecord  (input).  User  will  be  prompted 
to  enter  filenames  for  other  ZMTS  files  to  select  months 
from. 


Note:  All  input  files  must  be  in  the  same  format  (USGS  or 
NWDC),  contain  the  same  number  of  years,  and  begin 
with  the  same  month. 


Displaying  Monthly  Time  Series  Data 
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Program  BatdVProcedure 
Name  Filename 

GETl  RGETl  Time  series 

manipulation 


_ Program  Descripticm 

Extracts  records  from  a  multirecord  file. 

RGETl,  ZIN,ZOUT 
ZIN  “  Multirecord  file  (iiq)ut). 

ZOUT  *  File  with  selected  records  (output). 


Displaying  Monthly  Time  Series  Data 


Program  Batclt/Procedure 
Name  Filename  Rmcticxi 


LPTQHA  RLPTQHA  Displaying 

mcaithly  time 
series  data 


_ Program  PescripticHi _ 

Plots  monthly  habitat  area  or  streamflow  from  one  or  two  monthly 
time  series  files,  approximately  five  years  per  page.  Program  has  the 
option  to  plot  the  Y-axis  using  either  a  logarithmic  or  linear  scale. 

If  the  minimum  data  value  is  less  than  the  maximum  data  value 
divided  by  50.0,  then  the  Y-axis  will  be  logarithmic. 

RLPTQHA,  ZOUT,  ZMTS,  ZMTS2 

ZOUT  =  LPTQHA  results  (output). 


ZMTS  =  Monthly  time  series  file  in  USGS  or  NWDC  format  (in- 
put). 


ZMTS2  =  Second  monthly  time  series  file  in  USGS  or  NWDC 
format  (input). 


Note:  Input  files  do  not  have  to  be  in  the  same  format  or  con¬ 
tain  the  same  number  of  years;  however,  they  must  be¬ 
gin  with  the  same  month.  Multirecord  files  may  be  used. 


LPTTSN  RLPTTSN  Displaying  Reads  up  to  five  monthly  time  series  files  in  USGS  or  NWDC  format 

monthly  time  and  plots  the  data  in  a  user-specified  range  of  years.  Output 

series  data  includes  tables  and  plots. 

RLPTTSN,  ZOUT,  ZMTSl,  ZMTS2,  ZMTS3,  ZMTS4,  ZMTS5 

ZOUT  =  LPTTSN  results  (output). 

ZMTS  =  1-5  monthly  time  series  files  in  USGS  or  NWDC  format 
(input). 


Note:  Input  files  do  not  have  to  be  in  the  same  format  or  con¬ 
tain  the  same  number  of  years;  however,  they  must  be¬ 
gin  with  the  same  month.  Multirecord  files  carmot  be 
used. 
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Program 

Name 

MTSLST 


Program 

Name 

SCORTS 


LPTDUR 


BatdVProcedure 

Filemme  Rmction 

RMTSLST  EHsplaying 

monthly  time 
series  data 


_ RogramPescripticMi _ 

Produces  a  formatted  table  of  monthly  time  series  values  and  their  av¬ 
erages.  These  tables  are  useful  for  exporting  to  LXDTUS  1-2-3  or  other 
application  programs. 

RMTSLST,  ZMTS,  OUTMON,  OUTAVG 

ZMTS  *  Monthly  time  series  file,  can  be  multireccwd  (input). 


OUTMON  *  Table  of  time  series  data  listed  monthly  for  each  year 
(output). 


OUTAVG  =  Table  of  average  monthly  and  coefficient  of  variation 
values  (output). 


Analyzing  Monthly  Time  Series  Data 


BatdVProcedure 

Filename  Function 

RSCORTS  Analysis  of 
monlhly 
time  series 
data 


_ Program  Description _ 

Reads  a  monthly  time  series  file  and  calculates  several  statistical 
parameters,  including  log  normal  distributiem,  and  lag  one  correlation 
coefficients. 

RSCORTS,  ZMTS,  ZOUT,  ZANTS 


ZMTS  =  Monthly  time  series  file  in  USGS  or  NWDC  format;  can 
be  multirecord  (input). 

ZOUT  =  SCORTS  results  (output). 

ZANTS  =  Average  of  12  monthly  values  for  each  year  (output). 

RLPTDUR  Analy^  of  Reads  one  or  two  monthly  time  series  files  and  creates  an  output  file 

mc«ithly  time  arranged  either  by  groups  of  months  or  by  individual  months.  The  out- 

series  data  put  contains  annual  duration  tables  showing  ordered  monthly  data  for 

each  month  or  for  each  group  of  months,  an  exceedence  plot  for  each 
month,  a  summary  statistics  table  showing  average,  median,  index-A, 
index-B,  index-C,  10%,  20%,  80%,  90%  exceedence,  and  plots  show¬ 
ing  median,  average,  change  in  median,  and  change  in  average  for  the 
two  data  sets. 


RLPTDUR,  ZOUT,  ZMTS,  ZMTS2 
ZOUT  =  LPTDUR  results  (output). 

ZMTS  =  Mcttithly  time  series  file  in  USGS  or  NWDC  format  (input). 

ZMTS2  =  Second  monthly  time  series  file  in  USGS  or  NWDC  for¬ 
mat  (input). 


Note:  Input  files  do  not  have  to  be  in  the  same  format  or  con¬ 
tain  the  same  number  of  years;  however,  they  must  be¬ 
gin  with  the  same  month.  Input  files  may  be  multirecord. 


CHGFMT  Program 
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CHGFMT  Program 


Introduction  Running  CHGFMT 

The  CHGFMT  program  changes  a  USGS  format  file  to  RCHGFMT,  ZMTS,  ZMTSN 

a  NWDC  format  file  or  vice  versa.  The  files  can  be  any 

type  of  monthly  time  series  format  that  includes  monthly  ZMTS  ■  Monthly  time  series  file  in  USGS  or 

streamflow  files  (ZMONQ).  NWDC  format;  can  be  a  multirecord  file 

(input). 

ZMTSN  «  New  monthly  time  series  file  in  NWDC 
or  USGS  format;  will  be  a  multirecord 
file  if  ZMTS  is  (output). 
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COMMTS  Program 


Introduction 

The  COMMTS  program  reads  two  USGS  formatted 
records  and  does  a  month  by  month  weighted  sum  of  the 
two.  All  common  years  of  the  two  input  files  will  be 
combined  according  to  the  responses  given  by  the  user  at 
run  time.  If  the  data  is  out  of  order,  the  user  will  be  notified. 

The  monthly  time  series  files  must  be  in  USGS  format; 
use  the  CHGFMT  program  to  change  from  NWDC  to 
USGS  format,  if  needed. 

The  equation  used  in  the  COMMTS  program  is 

HAQy  -  A  *  HAl,y  +  B  *  HA2,y, 

where 

j  “  the  month  index, 
i  *  the  year  index, 

HAC,y  -  the  combined  value  for  month  j  and  year 
h 

HAly  ”  the  monthly  value  for  month  j  and  year  i 
from  the  first  time  series, 

HA2,y  “  the  monthly  value  for  month  j  and  year  i 
from  the  second  time  series, 

A  =  a  multiplier  for  the  fust  series  (supplied 
by  the  user),  and 

B  =  a  multiplier  for  the  second  series  (sup¬ 
plied  by  the  user). 

The  coefficients  A  and  B  are  any  values  the  user  elects  to  use. 

COMMTS  has  at  least  two  conceptual  uses.  First,  it  may 
be  used  as  the  most  elementary  of  networking  programs. 
For  example,  two  habitat  time  series  files  resulting  from 
HABTS  may  be  adjusted  for  segment  length  and  summed. 
This  will  allow  you  to  convert  from  WUA  (ft^/1,000  ft)  to 
total  habitat  (ft^)  by  multiplying  each  segment’s  WUA  by 


its  respective  reach  length.  For  example.  Segment  A  is  10 
miles  long  and  Segment  B  is  20  miles  long.  Entering 
weights  of  52.8  (5.28  x  10)  and  105.6  would  allow  you  to 
calculate  total  habitat  in  square  feet. 

The  second  use  of  COMMTS  would  be  to  combine  sets 
of  flow  time  series  data.  With  weights  equal  to  one,  simple 
tributary  addition  can  be  performed.  With  weights  unequal 
to  one,  scaling  flows  can  occur.  For  example,  one  data  set 
may  be  the  current  flow  time  series.  You  might  add,  or 
subtract,  from  the  current  flows  a  set  of  flows — for  in¬ 
stance,  Q — representing  a  proposed  alternative.  Scaling 
that  Q  set  may  allow  fine  tuning  of  the  alternative. 

Running  COMMTS 

RCOMMTS,  ZMTSl,  ZMTS2,  ZMTSN 

ZMTSl  =  Monthly  time  series  file  in  USGS  for¬ 
mat;  can  be  a  multirecord  file  (input). 

ZMTS2  =  Monthly  time  series  file  in  USGS  for¬ 
mat;  can  be  a  multirecord  file  (input). 

ZMTSN  =  Combined  monthly  time  series  file  in 
USGS  format  (output). 

The  title  lines  from  the  two  sets  of  data  will  be  displayed, 
and  then  the  following: 

li^CXSRAM  doliiif SeS;  ;  TWO'lif Ilibf 

A*pi- :•>  •  B*ij2  ■;  r'} ^  y;-;;-  'llll; 

■ ' ENTER  ‘A  ANjJ' -'B't  ■  • ' ' • ' •  ^ 

The  user  would  enter  coefficients  for  A  and  B  here. 

laJTEH  TWO  LINE  TITLE  FOE  COMBINED  PILEi 

ENTER  STATION  ID  (8  CHARE  MAX)  t _ • _ 
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GETl  Program 


Introduction 

The  GETl  program  extracts  records  from  a  multirecord 
file.  GETl  is  useful  for  a  variety  of  tasks  such  as  the 
extraction  of  a  single  life  stage’s  habitat  time  series  from 
the  file  created  by  HABTS. 

In  this  context,  a  multirecord  file  is  one  that  begins  with 
a  7-character  record  name  and  ends  with  #EOR,  as  op¬ 
posed  to  a  multirecord  ZHAQF  file  where  records  are 
separated  by  a  line  of  at  least  10  asterisks  (**********). 


CLASSAl 

SNOQUALMIE  RIVER 


FRY 

12142000 

RAINBOW 

1971  1 

TROUT 

16894 

14585 

16598 

12035 

12444 

16865 

12142000 

1971 

2 

15501 

8019 

9006 

10400 

17841 

17452 

12142000 

1972 

1 

16294 

12313 

15399 

15073 

11639 

9344 

12142000 

1972 

2 

12353 

8409 

8325 

12460 

18655 

15320 

12142000 

1973 

1 

17872 

16138 

13202 

16229 

18966 

19033 

12142000 

1973 

2 

17418 

14164 

14600 

17977 

17492 

17434 

«EOR 

CLASSA2 

SNOQUALMIE 

JUVENIL 

12142000 

RIVER 

RAINBOW 

1971  1 

TROUT 

11761 

12041 

11761 

10643 

12995 

12959 

This  format  has  the  following  requirements: 

1.  The  record  names  must  be  1  to  7  characters,  con¬ 
structed  with  the  characters  a-z,  A-Z,  and  0-9.  Other 
characters  may  be  legal  for  MS-DOS  applications  but 
will  not  be  legal  for  CDC  implementations.  The  re¬ 
cord  name  will  be  the  first  7  characters  on  the  first 
line. 

2.  The  end-of-record  marks  may  be  either  #EOR  or  #eor 
and  must  be  the  first  4  characters  on  a  line.  This 
special  end-of-record  mark  is  required  so  that  transfer 
of  this  data  file  using  the  CDC  CONNECT  software 
from  microcomputers  to  CDC  mainframes  will  work 


properly.  Conversely,  a  standard  CDC  multirecord 
data  file  will  contain  these  same  characters  if  trans¬ 
ferred  from  the  mainframe  to  micro  using  CON¬ 
NECT.  CONNECT  is  a  copyrighted  program  avail¬ 
able  for  free  distribution  to  CDC  users. 

3.  The  data  contained  in  the  text  data  must  be  standard 
ASCn  lines  less  than  or  equal  to  32,767  character  in 
length,  terminated  by  a  carriage  return-line  feed  se¬ 
quence.  (To  conform  to  CDC  standards,  however,  we 
recommend  that  a  line  be  no  longer  than  136  charac¬ 
ters.)  Any  ASCn  editor  will  create  such  a  file. 

Running  GETl 

RGETl,ZIN,ZOUT 

ZIN  =  Multirecord  file  (input). 

ZOUT  =  File  with  selected  records  (output). 

THE  INPUT  PILES  t - 9 

CONTAINS  THE  FOLLOWING  RECORDS s 


Example: 

1:  classAl 
2:  classA2 
3:  classA3 

'^kEC0Rbs?=iN  oSder  :  if  ' 


For  example,  if  classA2  and  classA3  are  to  be  extracted, 
2  would  have  been  entered  for  the  number  of  records  to 
extract  and  the  numbers  2  and  3  would  be  entered  for  the 
record  numbers. 

The  records  will  be  copied  to  a  data  file  with  the  name 
specified  when  the  program  was  run.  If  no  name  was 
specified,  the  filename  will  be  ZOUT. 
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LPTDUR  Program 


Introduction 

The  LPTDUR  program  reads  one  or  two  monthly  time 
series  files  and  creates  an  ontj^  file  arranged  either  by 
groups  of  months  or  by  individual  months.  The  output 
contains  annual  duration  tables  diowing  or^i^  monthly 
data  for  each  group  of  months  or  for  each  individual  month 
of  the  year,  an  exceedence  plot  for  each  month  (»  group  of 
months,  or  a  summary  statistics  table  showing  average, 
median,  index-A  (average  of  the  interval  between  50% 
duration  and  90  %  duration),  index-B  (average  of  the  interval 
between  10%  duration  and  90%  duration),  index-C  (a  user- 
defined  index),  10%,  20%,  80%,  90%  exceedence,  and  plote 
blowing  median,  average,  change  in  median,  and  change  in 
average  fca:  the  two  data  sets. 

Grouping  by  sets  of  months  is  useful  for  characterizing 
habitat  values  for  a  life  stage  that  is  only  present  for  a  few 
months.  Grouping  by  individual  months  is  useful  for  fine 
tuning  flow  recommendations  on  a  month  by  month  basis. 

Running  LPTDUR 

RLPTDUR,  ZOUT,  ZMTS,  ZMTS2 
ZOUT  =  LPTDUR  results  (output). 


set  and  will  appear  on  the  output  tables.  If  two  data  sets  were 
specified  as  input,  the  same  iMompt  will  appear  for  the 
second  data  set. 


ENTER  INDEX  FOR  FIRST  MONTH  OF  DATA  ETC.)  ; _ 

This  index  will  label  the  first  data  entry  on  the  input  data 
file(s)  with  the  corresponding  rntmth  name.  For  example,  if 
the  first  entry  on  the  data  file(s)  is  January,  enter  1.  If  the  first 
entry  on  the  data  file(s)  is  October,  oiter  10. 


Note:  If  two  input  files  were  specified,  they  must  both 
begin  with  the  same  month. 


If  option  0  was  selected  to  list  information  by  group  of 
months,  the  following  prompt  will  appear: 

EMTER  IKDEX  TOR  FIRST  MTO  LAST  VALID  MOUTHS  tSEP.»9.  BTC.) 

The  user  must  designate  the  series  of  consecutive  months 
of  data  to  be  included  for  this  run.  For  example,  entering  6 
and  10  will  plot  and  display  only  June  through  October  in 
each  year. 

If  option  1  was  selected  to  list  information  by  individual 
months,  the  follovring  prompt  will  appear: 


ZMTS  =  Monthly  time  series  file  in  USGS  or 
NWDC  format  (input). 

ZMTS2  =  Second  monthly  time  series  file  in  USGS 
or  NWDC  format  (input). 


Note:  Input  files  do  not  have  to  be  in  the  same  format 
or  contain  the  same  number  of  years;  however, 
they  must  begin  with  the  same  month.  Input 
files  may  be  multirecord. 

^"ENTERt  f)  V^'^LISt^INFt»RMATICJN  BY  GROUP" OF  MONTHS  ^ 

1  TO  LIST  INFORMATION  BY  INDIVIDUAL  MONTHS  ■  ■ 

The  output  file  will  either  be  arranged  by  a  group  of 
months  for  each  year  or  by  each  individual  month  for  each 
year.  If  you  choose  “Group  of  months",  you  will  later  be 
prompted  to  enter  the  first  and  last  valid  months  for  the  group 
of  months  of  data  to  be  included  in  this  run.  The  output 
contains  annual  duration  tables  showing  ordered  monthly 
data  for  each  month  or  group  of  months  for  each  year. 


ENTER  TABLE  LABEL  FOR  FIRST  SET  (UP  TO  14  CHAR) ;  _ 

The  program  will  display  the  first  two  lines  of  the  first  data 
set  for  user  identification.  The  label  should  identify  the  data 


ENTER  '  1  TO  PtXXr  SUMMARY  RESDtTS,  0  OTHERyflSE. _ 

If  1  is  entered,  the  index-A,  index-B,  index-C,  median,  and 
average  monthly  summary  statisties  will  be  plotted. 


tPTDOR  WILL  COMPOTE  INDEX-A  (50%  “90%)  AND  INDEX-B 

ENTCR  1  TO  define  an  INDEX -C,  0  OTHERWISE^ _ 

Index-C  may  be  useful  if  the  exceedence  values  described 
by  index-A  and  index-B  are  irrelevant  to  your  application  or 
do  not  cover  the  percentages  of  interest.  For  example,  if  the 
events  in  the  90-100%  exceedence  category  are  thought  to 
be  important  population  limiting  events,  then  you  may  wish 
to  define  index-C  as  covering  the  90-100%  exce^nce 
category. 

If  1  is  entered  to  define  an  Index-*C: 


ENTER  THE  LOWER  AND  UPPER  BOUNDARIES  FOR  INDEX -C; 
ENTER  1  TO  WRITE  DURATION  TABLE (S).  0  OTHERWISE, 


These  are  tables  showing  ordered  monthly  data  either  by 
individual  months  or  groups  of  months  depending  on  the 
option  selected. 


ilNTER-^;;; 


Kl-- PbR  DUR^  PLOT(S),  0  OTHERWISE. 
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These  are  monthly  (or  by  groups  of  months)  exceedence 
plots. 

If  tables  or  plots  are  to  be  written: 

BMTER  PLOT  Affl)  imATXOK  TABLE  TITLE  tlNE  {V?  TO  70  CHARACTERS)  ; 


This  title  will  appear  below  the  X-axis  on  plots  and 
above  each  duration  table. 


iiSfESg;:;:;:;; 

1  FOR  LOO-LINEAR  PLOT.  0  FOR  LINEAR «-LTNBAR . 

The  Y-axis  will  represent  the  data  values.  Enter  1  for  the 
X-axis  on  a  log  scale  or  0  for  the  X-axis  on  a  linear  scale. 


The  following  prompt  will  appear  if  the  linear-4inear 
plotting  option  is  chosen.  For  log-linear,  the  X-axis  will 
automatically  begin  at  the  minimum  X  data  value. 


.0:...  .... to... 

ENTER  1  TO  EEOXH  AT  MINIHOH  X-PATA  VAttJE 

ENTER  X-AXIS  LABEL  (QE  TO  10  CHARACTERS) _ 

This  X-axis  label  will  appear  on  the  exceedence  plot. 
The  label  should  describe  the  type  of  input  data  and 
possibly  the  units. 

Figure  8.5  contains  sample  output  from  the  LPTDUR 
program. 


PROGRAM  -  LPTDUR 
PAGE  -  1 


FIRST  DATA  SET  IS  > 

SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


DATE  -  90/06/05.  SNOQUALMIE  RIVER 

TIME  -  11.58.49.  FRY  RAINBOW  TROUT 


YEAR  OCT  NOV 


DEC 


JAN  FEB 


MAR  APR  MAY 


JUNE  JULY  AUG 


SEPT 


1971 

1972 

1973 

1974 

1975 

1976 

1977 

1978 

1979 

1980 

1981 

1982 


16894.00  14585,00  16598.00  12035.00  12444.00  16865.00  15501.00  8019.00  9006.00  10400.00  17841.00 
16294.00  12313.00  15399.00  15073.00  11639.00  9344.00  12353.00  8409.00  8325.00  12460.00  18655*00 
17872.00  16138.00  13202.00  16229.00  18966.00  19033.00  17418.00  14164.00  14600.00  17977  00  17492  00 
15879.00  14592.00  10831.00  12325.00  15749.00  13271.00  11672.00  10222.00  7804.00  1012l!oO  18474!oO 
18218.00  14871.00  13755.00  13843.00  15871.00  16687.00  18945.00  9960.00  9786.00  14472  00  17169*00 
14953.00  11717.00  10860.00  11302.00  17715.00  18909.00  14929.00  10597.00  12494.00  1481l!oO  18238!oO 
16681.00  16269.00  16253.00  16897.00  17474.00  17980.00  13293.00  13607.00  15855.00  17876.00  17495!oO 
17725.00  11887.00  12576.00  16373.00  17150.00  16754.00  16876.00  13973.00  16614.00  18622.00  17352!oo 
17986.00  15351.00  16165.00  18184.00  14082.00  14780.00  14224.00  10697.00  15320.00  17188.00  16979!oO 
17148.00  17548.00  11464.00  17626.00  14897.00  17149.00  12386.00  15392.00  15625.00  18762.00  16667  00 
17381.00  12436.00  10624.00  18758.00  13237.00  19253.00  12931.00  13102.00  11700.00  19105.00  1667o!o0 
15170.00  16546.00  14496,00  14170.00  12447.00  15264.00  16186.00  10901.00  10577.00  16605.00  17271.00 


17452.00 
15320.00 
17434.00 
17152.00 
17229.00 
17802.00 
17694.00 
16031.00 
17094.00 
16649.00 
16783.00 
16979 .00 


SECOND  DATA  SET  IS  ■ 


DATE  -  90/06/05.  SNOQUALMIE  RIVER 

TIME  -  11.58.49.  FRY  RAINBOW  TROUT 


PROGRAM  -  LPTDUR 
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MONTHLY  HABITAT  TIME  SERIES  ANALYSIS  -  1971-82 

ORDERED  MONTHLY  DATA  FOR  JUN  THRU  OCT 


PRE- 

•  PROJECT 

ORDER 

PLOTTING 

NUMBER 

YEAR 

ELEMENT  POINT 

1 

1981 

19105.00  0.83 

2 

1980 

18762.00  2.50 

3 

1972 

18655.00  4.17 

4 

1978 

18622.00  5.83 

5 

1974 

18474.00  7.50 

6 

1976 

18238.00  9.17 

7 

1975 

18218.00  10.83 

8 

1979 

17986.00  12.50 

9 

1973 

17977.00  14.17 

10 

1977 

17876.00  15.83 

11 

1973 

17872.00  17.50 

Fig.  8.5.  Sample  output  from  the  LPTDUR  program.  This  output  was  generated  using  one  input  file  and  selecting  the  option  to 
list  information  by  group  of  months.  June  through  October  were  the  valid  months.  Tables  and  plots  were  both  requested. 
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12 

1971 

17841.00 

19.17 

13 

1976 

17802 . 00 

20.83 

14 

1978 

17725.00 

22.50 

15 

1977 

17694 . 00 

24 . 17 

16 

1977 

17495.00 

25.83 

17 

1973 

17492 . 00 

27 .50 

18 

1971 

17452.00 

29.17 

19 

1973 

17434.00 

30.83 

20 

1981 

17381.00 

32.50 

21 

1978 

17352.00 

34.17 

22 

1982 

17271.00 

35.83 

23 

1975 

17229.00 

37 . 50 

24 

1979 

17188.00 

39.17 

25 

1975 

17169 .00 

40.83 

26 

1974 

17152.00 

42.50 

27 

1980 

17148.00 

44.17 

28 

1979 

17094.00 

45.83 

29 

1979 

16979,00 

47.50 

30 

1982 

16979.00 

49.17 

31 

1971 

16894.00 

50.83 

32 

1981 

16783 .00 

52.50 

33 

1977 

16681.00 

54.17 

34 

1981 

16670.00 

55.83 

35 

1980 

16667.00 

57.50 

36 

1980 

16649.00 

59.17 

37 

1978 

16614.00 

60.83 

38 

1982 

16605.00 

62,50 

39 

1972 

16294.00 

64 . 17 

40 

1978 

16031.00 

65.83 

41 

1974 

15879 .00 

67.50 

42 

1977 

15855.00 

69.17 

43 

1980 

15625.00 

70.83 

44 

1979 

15320.00 

72.50 

45 

1972 

15320.00 

74 . 17 

Duration  table  terminated  for  brevity. 


DATE  -  90/06/05.  SNOQUALMIE  RIVER 

TIME  "  11.58.49.  FRY  RAINBOW  TROUT 

SUMMARY  STATISTICS  FOR  JUN  THRU  OCT 
PRE -  PROJECT 


AVERAGE  =  15870.466 

MEDIAN  =  16936.500 

INDEX-A  *  15213.021 

INDEX'S  =  16352.300 

INDEX-C  =  14642.374 

10  PERCENT  =  18228.000 

20  PERCENT  =  17821.500 

80  PERCENT  =  14705.500 

90  PERCENT  =  10488.500 


0.000 
0.000 
0.000 
0.000 
0.000  *** 
0.000 
0.000 
0.000 
0.000 


***  INDEX-C  IS  THE  AVERAGE  PERCENTAGE  EXCEEDENCE 
BETWEEN:  50.00  AND  95.00 


PROGRAM  -  LPTDUR 
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Fig.  8.5.  Continued 
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DATE  ~  90/06/05. 
TIME  -  11.58.49, 


SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


PROGRAM  -  LPTDUR 
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Fig.  8.5.  Continued, 
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LPTQHA  Program 


Introduction 

The  LPTQHA  program  plots  monthly  habitat  area  or 
streamflow  from  one  or  two  monthly  time  series  files, 
approximately  five  years  per  page.  The  program  has  the 
option  to  plot  the  Y-axis  using  either  a  logarithmic  or  linear 
scale.  If  the  minimum  data  value  is  less  than  the  maximum 
data  value  divided  by  50.0,  then  the  Y-axis  will  be  loga¬ 
rithmic. 

Running  LPTQHA 

RLPTQHA,  ZOUT,  ZMTS,  ZMTS2 

ZOUT=  LPTQHA  results  (output). 

ZMTS  *  Monthly  times  series  file  in  USGS  or 
NWDC  format  (input). 

ZMTS2  =  Second  monthly  time  series  file  in  USGS 
or  NWDC  format  (input). 


Note:  Input  files  do  not  have  to  be  in  the  same  format 
or  contain  the  same  number  of  years;  however, 
they  must  begin  with  the  same  month.  Multi¬ 
record  files  may  be  used. 


1  IF  INFVT  DATA  FILFS  eOKTAIif  ftjCMS 
ENTER  0  IF  CONTAIK  HASltAt  AREAS 

ENTER  2  FOR  LDQ -LINEAR  1  FOR  LINEAR -LINEAR  a 


The  X-axis  will  represent  time,  in  months,  on  a  linear 
scale. 

The  Y-axis  will  represent  the  data  values. 

Enter  2  for  the  Y-axis  on  a  log  scale  or  1  for  the  Y-axis 
on  a  linear  scale.  If  the  minimum  data  value  is  less  than  the 
maximum  data  value  divided  by  50.0,  then  the  Y-axis  is 
logarithmic. 


ENTER  INDEX  FOR  FIRST  MONTH  OF  t>ATA  (OCT. ■  10.  ETC.)  ; 


This  index  will  label  the  first  data  entiy  on  the  input  data 
file(s)  with  the  corresponding  month  name.  For  example, 
if  the  first  entry  on  the  data  file(s)  is  January,  enter  1 .  If  the 
first  entry  on  the  data  file(s)  is  October,  enter  10. 


Note:  If  two  input  files  were  specified,  they  must  both 
begin  with  the  same  month. 


Renter  FIRST  month  and  last  month  of  valid  mcwths. 


The  user  must  designate  the  series  of  consecutive 
months  of  data  to  be  included  for  this  run.  For  example, 
entering  6  and  10  will  plot  and  display  only  June  through 
October  in  each  year. 

Figure  8.6  contains  sample  output  from  the  LPTQHA 
program. 


89/01/23.  H  12142000  4736541214244005353033SW17110010  64.00  1130.00  PROGRAM  -  LPTQHA 

17.45.12.  N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA.  PAGE  0 

EFFECTIVE  FOR  EACH  GRAPH  INDIVIDUALLY,  THE  PLOTTING 
SYMBOLS  USED  REPRESENT  THE  ORDER  IN  WHICH  THE  DATA  WERE 
PLOTTED.  THE  ORDER  IS  ILLUSTRATED  IN  THE  FOLLOWING  EXAMPLE 
OF  TWO  DATA  FILES,  EACH  CONTAINING  3  YEARS  OF  DATA: 

PLOTTING  SYMBOL  =  A  FOR  VALID  MONTHS  OF  YEAR  1,  DATA  FILE  1 

PLOTTING  SYMBOL  =  B  FOR  VALID  MONTHS  OF  YEAR  2,  DATA  FILE  1 

PLOTTING  SYMBOL  =  C  FOR  VALID  MONTHS  OF  YEAR  3,  DATA  FILE  1 

PLOTTING  SYMBOL  =  D  FOR  VALID  MONTHS  OF  YEAR  1,  DATA  FILE  2 

PLOTTING  SYMBOL  =  E  FOR  VALID  MONTHS  OF  YEAR  2,  DATA  FILE  2 

PLOTTING  SYMBOL  =  F  FOR  VALID  MONTHS  OF  YEAR  3,  DATA  FILE  2 

WHEN  2  OR  MORE  POINTS  LIE  ON  TOP  OF  ONE  ANOTHER,  ONLY  THE 
PLOTTING  SYMBOL  FOR  THE  LAST  OF  THE  POINTS  IS  USED. 

Fig.  8.6.  Sample  output  from  the  LPTQHA  program.  This  output  was  generated  using  one  monthly  habitat  time  series  file  as 
input — only  the  output  for  Rainbow  trout — ^Fry,  years  1971-75  has  been  included. 
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90/06/18. 

09.39.56. 

19.253 


18.108 


16.963 


15.818 


14.673 

HA  FT2/FT 
13.528 

12.384 

11.239 


10.094 


8.9489 


7.8040 


SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


1  1 

1  1 

1  C  1 
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#  B 

# 

# 

# 
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# 

# 

# - 

# 

# 

# 


#  B 

#  - 

# 

# 

#  -  B 

# 

#  1  1 

#  1  1 

#  1  1 

5.0000  17.000 

11.000 


B 


C 


C 


1  1  1 

1  1C  1 

1  1  1 


29.000 

23.000  35.000 
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MONTHS  ARE  IN  CALENDAR  YEARS,  VALID  MONTHS:  JUN  TO  OCT  YEARS:  1971  TO  1975 


Fig.  8.6.  Continued, 
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LPTTSN  Program 

Introduction 

The  LPTTSN  program  reads  up  to  five  monthly  time 
series  files  in  USGS  or  NWDC  format  and  plots  the  data 
in  a  user-specified  range  of  years.  Output  includes  tables 
and  plots.  The  plots  can  be  displayed  on  the  screen  or 
written  to  the  output  file. 

Running  LPTTSN 

RLPTTSN,  ZOUT,  ZMTSl,  ZMTS2,  ZMTS3, 
ZMTS4,ZMTS5 

ZOUT  *  LPTTSN  results  (output). 

ZMTS(l-5)  “  Monthly  time  series  files  in  USGS  or 
NWEKZ!  format  (input). 

Note:  Input  files  do  not  have  to  be  in  the  same  format 
or  contain  the  same  number  of  years;  however, 
they  must  begin  with  the  same  month.  Multi¬ 
record  files  cannot  be  used.  The  maximum  per¬ 
missible  number  of  fiow-versus-time  data  pairs 
is  1,200  (100  years  of  data). 

The  title  lines  from  each  of  the  input  files  will  be  dis¬ 
played  on  the  screen  and  you  will  be  instructed  to  enter  a 
<CR>  to  continue. 

Display  options; 

IHPRINT  TABtES  OF  VARIABLE  VfdJmS 
2-^0  COLUMN  PRINTER  PLOT 

COLUMN  PJ^INTER  PLOT  'j  *1 

ENTER  OPTION;  ■  ■  ■  / \ 

Specify  if  you  want  to  print  the  monthly  time  series 
values  in  tabular  form,  print  out  an  80-column  plot  of  the 
data,  or  print  out  a  130-column  plot.  Figure  8.7  contains 
sample  output  when  option  1  (Print  tables  of  variable 
values)  is  selected.  Figure  8.8  is  a  80-column  printer  plot 
(option  2). 

ENTER  0  ~  DISPLAY  TO  MONITOR 

OR  I  OUTPUT  RESULTS  TO  COMPUTER  FILE;. _ _ 

The  program  prompts  for  your  choice  of  output  destina¬ 
tion.  If  you  choose  to  display  the  output  to  the  monitor, 
enter  0.  If  you  want  to  produce  a  file  on  disk,  enter  1 .  This 
will  be  the  ZOUT  filename  specified  previously. 


Enter  a  title  line  of  up  to  80  characters  for  the  output. 
The  plots  (or  table  if  option  1  was  selected  to  print  tables 
of  variable  values)  will  be  labeled  with  this  title. 

enter  Y-axis  label  or  C0LtJ^m  TITLE^.  so  C^AR; _ 

Enter  a  label  for  the  Y-axis  (dependent  variable  axis).  If 
option  was  selected  to  print  a  table  of  variable  values,  this 
will  be  the  column  title. 

The  active  years  in  each  of  the  input  data  files  are 
displayed.  After  each  input  data  file  (or  after  each  monitor 
screen  full  of  years)  the  program  will  pause  with  a  request 
to  press  a  <CR>  to  continue  the  list. 

ENTER  BEGINNING  AND  ENDING  YEARS  TO  BE  PLOTTED  i _ 

These  do  not  have  to  be  the  lowest  and  highest  years  in 
the  data.  If  specified  years  are  not  in  the  data,  the  program 
will  skip  those  years.  Specify  years  by  entering  the  years, 
separated  by  a  conuna,  a  carriage  return,  or  one  or  more 
spaces. 

If  1  was  selected  in  the  display  options  prompt  “Print 
table  of  variable  values,”  the  following  prompt  will  not 
appear.  The  program  will  return  to  the  display  options 
prompt. 

ENTER  Y'AXIS  LOW  AND  HIGH  SCALE  VALUES 

OR  0,0  FOR  DEFAULT  SCALING  AND  STATISTICS 
OR  -1,-1  FOR  STATS  ONLY 

If  you  enter  the  low  and  high  values,  the  program  sets 
the  lowest  and  highest  bounds  on  the  plots  at  those  values. 
If  the  plot  exceeds  these  limits,  a  “<”  or  “>”  symbol 
appears  on  the  graph  to  indicate  that  the  value  read  from 
the  input  data  files  was  less  than  or  greater  than  the 
indicated  limits,  respectively. 

If  you  want  the  program  to  scale  the  data  from  values 
read  from  the  input  data  files,  enter  0,0.  The  program  will 
choose  default  values  to  cover  the  range  in  the  data  files. 
We  recommend  selecting  this  option. 

If  you  enter  -1,  ~1,  then  only  the  maximum  and  mini¬ 
mum  values  are  displayed  for  each  data  input  file.  This  is 
convenient  if  you  want  to  avoid  using  the  default  values 
but  are  not  aware  of  the  range  of  values  in  the  data.  K  you 
choose  this  option,  the  program  will  “cycle”  back  so  you 
can  reenter  the  low  and  high  values  for  a  plot. 
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N.F.  SNOgUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS,  WA  (Table  Title) 


YEAR . MO 

Column  Title 
12142000 

1930.01 

118.68 

1930.02 

129.63 

1930.03 

511.29 

1930.04 

242.74 

1930.05 

980.32 

1930.06 

449.00 

1930.07 

539.23 

1930.08 

473.39 

1930.09 

398.17 

1930.10 

114.97 

1930.11 

45.00 

1930.12 

76.60 

1931.01 

491.74 

1931.02 

290.50 

1931.03 

259.58 

1931.04 

674.84 

1931.05 

397 .57 

1931.06 

681.58 

1931.07 

576  .97 

1931.08 

539.48 

1931.09 

520.20 

1931.10 

121.84 

1931.11 

52.42 

1931.12 

224.97 

1932.01 

467.19 

1932.02 

542.30 

1932.03 

407 .65 

1932.04 

537.39 

1932.05 

626.48 

1932.06 

1071.00 

1932.07 

946,37 

1932.08 

883.68 

1932.09 

905.93 

1932.10 

483.45 

1932 . 11 

143.65 

1932.12 

171.00 

Fig.  8.7.  Sample  output  (table  of  variable  values)  from  the  LPTTSN  progiam. 


After  you  have  specified  the  low  and  high  values,  the 
program  will  produce  its  major  output  and  return  to  the 
Display  options  prompt.  If  you  specified  monitor  output, 
the  output  data*-plots  are  shown  on  the  monitor.  If  you 
specified  computer  file  output,  all  results  from  this  session 
will  be  written  to  the  filename  specified  when  the  program 
was  initialized. 

If  display  option  1,  Print  tables  of  variable  values,  is 
selected  the  output  will  consist  of  the  same  values  read 


from  the  monthly  time  series  files,  written  in  tabular  form. 
Columns  of  time  series  data  are  headed  by  the  gaging 
station  identifiers  read  from  the  input  data  files. 

When  Display  option  2  (80-Column  printer  plot)  or  3 
( 1 30-Column  printer  plot)  is  chosen,  an  80-  or  1 30-column 
plot  is  made  to  either  the  monitor  display  or  computer  disk 
file,  depending  on  the  user-selected  output  device.  The 
first  file  specified  is  plotted  as  A,  the  second  file  as  B,  and 
so  on.  Figure  8.8  is  an  example  of  80-column  output. 
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DATA  MINIMA 
12142000 
45.00 

DATA  MAXIMA 
12142000 
1071.00 


SNOQUALMIE  RIVER  STUDY  (Plot  Title) 

MONTHLY  MEAN  DISCHARGE  (Y-Axis  Label) 


YEAR. MO 

3  .OOE+01 

1930.00  + - 

1930.01  +  A 
1930.02  +  A 
1930.03  + 
1930.04  + 
1930.05  + 
1930.06  + 
1930.07  + 
1930.08  + 
1930.09  + 

1930.10  +  A 

1930.11  A 

1930.12  +A 
1931.01  + 
1931.02  + 
1931.03  + 
1931.04  + 
1931.05  + 
1931.06  + 
1931.07  + 
1931.08  + 
1931.09  + 

1931.10  +  A 

1931.11  A 

1931.12  + 
1932.01  + 
1932.02  + 
1932.03  + 
1932.04  + 
1932.05  + 
1932.06  + 
1932.07  + 
1932.08  + 
1932,09  + 

1932.10  + 

1932.11  +  A 

1932.12  +  A 


4.24E+02 


A 


A 


A 

A 

A 

A 


A 

A 

A 


A 


A 

A 

A 


A 


A 


A 

A 


A 


8.18E+02 


A 


A 

A 


A 


A 

A 

A 


1.21E+03 


A 


1.61E+03 


Fig.  8.8.  Sample  output  (80-coluinn  printer  plot)  from  the  LPTTSN  program.  When  two  or  more  files  a) 
tion  identifiers  are  aligned  with  their  minimum  and  maximum  data  values.  Overplots  of  data  (where 
tion  in  the  plot)  are  shown  by  an  asterisk  (*).  The  symbols  are  used  as  scale  markings. 


2.00E+03 


re  used  as  input,  the  sta- 
files  have  the  same  posi- 
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MTSLST  Program 


Introduction 

The  MTSLST  program  produces  a  formatted  table  of 
monthly  time  series  values  and  their  averages.  These  tables 
are  useful  for  exporting  to  LOTUS  or  other  application 
programs. 

The  MTSLST  program  requires  one  input  file  that  lists 
12  values  for  each  year  and  generates  2  output  files.  One 
output  file  contains  the  average  monthly  and  coefficient  of 
variation  values  for  the  data  set,  and  the  other  consists  of 
the  time  series  values  listed  monthly  for  each  year  as  well 
as  summary  statistics. 

MTSLST  accepts  a  wide  variety  of  input  data  file  for¬ 
mats;  however,  it  is  restricted  to  data  files  containing  a 
record  identifier.  The  input  files  may  be  multirecord  files. 
The  following  is  a  sample  free-formatted  file: 

CLASSAl 

UPPER  MAIN  STEM  OF  ST.  VRAIN  CREEK  BELOW  LYONS,  COLORADO 
FRY  RAINBOW  TROUT 


12345678 

(8  digit  station  number) 

1930 

118.68 

129.63  511.29 

242.74 

980.32 

449.00 

539.23 

473.39  398.17 

114 .97 

45.00 

76.60 

1931 

. . .  (more  data 

here)  .  . 

946.37 

#EOR 

883.68  905,93 

483.45 

143.65 

171.00 

Running  MTSLST 

RMTSLST,  ZMTS,  OUTMON,  OUTAVG 

ZMTS  =  Monthly  time  series  file;  can  be  multi- 
record  (input). 

OUTMON  «  Table  of  time  series  data  listed  monthly 
for  each  year  (output). 

OUTAV G  =  Table  of  average  monthly  and  coefficient 
of  variation  values  (output). 


Snter  Index  to  first  Month  of  data  oct.-io,  etc.^ 


ENTER  UNITS  (10  CHARI 


This  prompt  is  asking  for  the  units  to  be  given  to  the  data 
being  input.  This  will  appear  in  the  output  file  with  the 
data.  Example;  CFS,  SQIT/IOOO',  etc. 

C$EVEW 

:  ■■  POR'  ; 'nwdc  ‘  :Pii:P  P 

4''  roR  [  (5x|t4|ix  1 1  v  •  I'P  IpN  :3:  ■; 

^  ^  5  ■  ;■  ji® iilji  ^ ;  H'P-  PI Siii. 

Illll:’;' :  ••  p .. ■  ■=  •  V  'PI  •  P  I?;  'Sf ill 

p?' ■ : x>.  ifi: ;ii^' •  ■  Jilil :> ; •  •  ' ; ■  lliiplll 

There  are  several  choices  for  the  format  of  the  input. 
Each  one  will  be  briefly  described  by  way  of  FORTRAN 
format  statement  syntax.  As  a  sample  interpretation,  lOX, 
14,  IX,  12F5.2  would  be  a  line  with  10  blanks  (lOX),  an 
integer  of  length  4  (14),  another  space  (IX),  and  12  floating 
point  numbers  of  length  5  including  2  to  the  right  of  the 
decimal  point  (12F5.2). 


FOUR  FORMATS  CAN  BE  USED  FOR  LISTING  OF  TIME  SERIES 

•ENTER  0  FOR  XXX 
pp:;....:  •  X  FOR  XXX.  X 

2  FOR  XXX.XX  '-  ' 

3  FOR  LOTOS  MOLTtFtE  COLOMNS 

4  FOR  LOTOS  SINGLE  COLtM4  WITH  NO  TITLES  AND 

•  .  NO 'S^I^ICS  . 


The  output  can  be  listed  with  various  digits  being  al¬ 
lowed  to  the  right  of  the  decimal  point  (illustrated  by  x’s 
in  place  of  variable  digits)  or  in  two  different  Lotus  1-2-3 
formats. 

The  program  then  lists  the  names  of  the  stations  for  the 
data  analyzed  and  how  many  stations  were  reviewed. 

Figure  8.9  contains  sample  output  from  OUTMON  file 
in  Lotus  multiple-columns  format;  Fig.  8.10  contains 
sample  output  from  the  OUTAVG  file  in  Lotus  multiple- 
columns  format.  The  sample  ZMTS  file  in  Appendix  A 
was  used  as  input. 


Enter  the  number  of  the  month  of  the  year.  For  example, 
entering  ”10”  would  indicate  that  the  first  month  of  input 
data  is  October. 
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'90/05/23. 

"13.50.48. 


SNOQUALMIE 

FRY 


RIVER 

RAINBOW  TROUT 


PROGRAM  -  MTSLST 
PAGE  -  1 


1971  1 

1971 
1971 
1971 
1971 
1971 
1971 
1971 
1971 
1971 
1971 
1971 


16894 .00 
14585.00 
16598.00 
12035.00 
12444.00 
16865.00 
15501.00 
8019 .00 
9006 .00 
10400.00 
17841.00 
17452.00 


(sample  terminated) 


2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 


"90/05/23.  SNOQUALMIE  RIVER 

"13.50.48.  FRY  RAINBOW  TROUT 


PROGRAM  -  MTSLST 
PAGE  -  2 


"STATION  ID:  142000 

"  NO.  OF  YEARS:  12 
"RECORD  NAME:  CLASSAl 


"AVERAGE  MONTHLY  RATE 


"J 

MONTH 

sqft/1000' 

COEF.  OF  VARIATION 

MAXIMUM 

MINIMUM 

1 

OCT 

16850,08400 

0.06188 

18218.00 

14953.00 

2 

NOV 

14521.08300 

0.13153 

17548.00 

11717 .00 

3 

DEC 

13518.58300 

0.16035 

16598.00 

10624 . 00 

4 

JAN 

15234.58300 

0. 15757 

18758.00 

11302.00 

5 

FEB 

15139 . 25000 

0.15163 

18966 . 00 

11639.00 

6 

MAR 

16274 . 08300 

0.16654 

19253 . 00 

9344.00 

7 

APR 

14726 .16700 

0.14981 

18945.00 

11672.00 

8 

MAY 

11586 .91700 

0.19739 

15392.00 

8019 . 00 

9 

JUN 

12308.83300 

0.24960 

16614 . 00 

7804 . 00 

10 

JUL 

15699 .91700 

0.19673 

19105.00 

10121.00 

11 

AUG 

17525 .25000 

0.03599 

18655.00 

16667.00 

12 

SEP 

16968.25000 

0.03998 

17802.00 

15320.00 

Fig.  8.9.  Sample  output  (OUTMON  file)  from  the  MTSLST  program. 
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SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 

MEAN  MONTHLY  VALUES  AND  COEFF  OF  VARIATION  IN  sqft/lOOO' 


*  1 

OCT 

16850.08 

0.062 

*  2 

NOV 

14521.08 

0.132 

*  3 

DEC 

13518.58 

0. 160 

*  4 

JAN 

15234.58 

0.158 

*  5 

FEB 

15139,25 

0.152 

*  6 

MAR 

16274.08 

0.167 

*  7 

APR 

14726.17 

0.150 

*  8 

MAY 

11586.92 

0,197 

*  9 

JUN 

12308.83 

0.250 

*10 

JUL 

15699.92 

0.197 

*11 

AUG 

17525.25 

0.036 

*12 

SEP 

16968.25 

0.040 

#EOR 


SNOQUALMIE  RIVER 

JUVENIL  RAINBOW  TROUT 


MEAN 

MONTHLY  VALUES 

AND  COEFF  OF  VARIATION  IN  sqft/lOOO 

*  1 

OCT 

9109.67 

0.207 

*  2 

NOV 

11496,58 

0.154 

*  3 

DEC 

12206.67 

0.080 

*  4 

JAN 

11344.25 

0.125 

*  5 

FEB 

12138.17 

0.112 

*  6 

MAR 

12547.83 

0.094 

*  7 

APR 

13647.33 

0.051 

*  8 

MAY 

13201.00 

0.119 

*  9 

JUN 

12899.92 

0.112 

*10 

JUL 

11073 .92 

0.211 

*11 

AUG 

8143.83 

0,230 

*12 

SEP 

8679.33 

0.236 

#EOR 

SNOQUALMIE 

RIVER 

ADULT  RAINBOW  TROUT 


MEAN  MONTHLY  VALUES  AND  COEFF  OF  VARIATION  IN  sqft/lOOO' 


*  1 

OCT 

6796.58 

0.258 

*  2 

NOV 

9309.25 

0.195 

*  3 

DEC 

10065.67 

0.087 

*  4 

JAN 

8987.58 

0.160 

*  5 

FEB 

9683.00 

0.129 

*  6 

MAR 

9760.33 

0.123 

*  7 

APR 

11176 .83 

0.090 

*  8 

MAY 

11549 .75 

0.088 

*  9 

JUN 

11089.42 

0.079 

*10 

JUL 

8775.50 

0.303 

*11 

AUG 

5819.08 

0.257 

*12 

#EOR 

SEP 

6369  .75 

0.278 

Fig.  8.10.  Sample  output  (OUTAVG  file)  from  the  MTSLST  program. 
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MULMTS  Program 


Introduction 

The  MULMTS  program  multiplies  all  data  in  a  monthly 
time  series  file  in  USGS  or  NWDC  format  by  a  constant. 
The  output  file  is  in  the  same  format  as  the  input  file. 

One  example  of  the  use  of  the  MULMTS  program  would 
be  to  calculate  total  habitat.  In  this  case,  you  would  multi¬ 
ply  the  WUA  (ft^/1,000  ft)  by  the  reach  length  in  miles  to 
obtain  total  square  feet. 

Running  MULMTS 

RMULMTS,  ZMTS,  ZMTSN 

ZMTS  =  Monthly  time  series  file  in  USGS  or 
NWDC  format;  can  be  a  multirecord  file 
(input). 

ZMTSN  ~  New  monthly  time  series  file  after  mul¬ 
tiplication  (output). 


The  title  lines  from  the  input  file  will  be  displayed.  This 
will  help  to  verify  that  the  correct  file  is  being  multiplied. 

tarrgR  _ 


Enter  the  value  by  which  you  want  the  entries  to  be 
multiplied.  For  example,  if  2  is  entered,  the  values  in  the 
input  file  will  be  doubled  in  the  output  file. 

The  record  numbers  in  the  input  file  will  be  displayed  as 
they  are  being  multiplied. 

Example: 

WORKING  ON— CLASSAl 
WORKING  ON— CLASSA2 
WORKING  ON— CLASSA3 
WORKING  ON— CLASSA4 
On  completion  of  the  run,  you  will  be  told  how  many 
records  were  multiplied  by  the  given  value. 

tH  RECORDS  MULTIPLIED  BY  '  ) 
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SCORTS  Program 


Introduction 

The  SCORTS  program  reads  a  monthly  time  series  file 
and  calculates  several  statistical  parameters,  including  log 
normal  distributions  and  lag  one  correlation  coefficients. 

Either  USGS  or  NWDC  formatted  files  may  be  used  as 
input  to  SCORTS.  When  streamflow  is  contained  in  the 
input  file,  it  is  assumed  that  discharge  (Q)  is  in  cubic  feet 
per  second  (cfs)  and  that  the  flows  are  ordered  by  month. 

Running  SCORTS 

RSCORTS,  ZMTS,  ZOUT,  ZANTS 

ZMTS  =  Monthly  time  series  file  in  USGS  or 
NWDC  format;  can  be  a  multirecord  file 
(input). 

ZOUT  =  SCORTS  results  (output). 

ZANTS  =  Average  of  12  monthly  values  for  each 
year  (output). 

Figure  8.11  contains  sample  output  from  the  ZANTS  file 
from  the  SCORTS  program;  Fig.  8. 12  contains  output  from 
the  ZOUT  file. 

The  ZOUT  file  contains  all  monthly  and  annual  calcula¬ 
tions  determined  by  SCORTS.  This  output  assumes  that 
streamflow  was  used  as  input. 

1.  A  listing  of  monthly  values  with  each  year’s  annual 
total  in  cfs. 

2.  A  lognormal  distribution  for  the  data  set,  listing 
monthly  distributions  for  this  sample,  where  Qn  is  the 
discharge  not  exceeded  n  percent  of  the  years  (i.e., 
Q50,  n  =  50,  discharge  not  exceeded  50%  of  the  years 


NORTH  FORK 

SNOQUALMIE 

RIVER  NEAR  SNOQUALMIE  FALLS  WASH 

MEAN  MONTHLY  DISCHARGE 

-  1962  THRU  1977 

AQ12142000 

1962 

481.7 

AQ12142000 

1963 

421.4 

AQ12142000 

1964 

601.0 

AQ12142000 

1965 

497.4 

AQ12142000 

1966 

436.9 

AQ12142000 

1967 

518.4 

AQ12142000 

1968 

600.8 

AQ12142000 

1969 

534.8 

AQ12142000 

1970 

429.5 

AQ12142000 

1971 

588.6 

AQ12142000 

1972 

735.6 

AQ12142000 

1973 

363.4 

AQ12142000 

1974 

664.4 

AQ12142000 

1975 

509.7 

AQ12142000 

1976 

627.8 

AQ12142000 

1977 

358.5 

[median]).  Also,  Q50-Q10  is  the  difference  be¬ 
tween  the  median  discharge  and  the  discharge  not 
exceeded  10%  of  the  years.  This  gives  some  idea  as 
to  the  water  available  for  allocation  between  alterna¬ 
tive  uses  (i.e.,  instream  flow  uses). 

3.  A  variety  of  statistical  parameters  are  listed,  such  as 
the  mean  monthly  discharge,  monthly  coefficient  of 
variation,  and  the  monthly  standard  deviation.  The 
number  of  years  in  the  data  set  is  the  sample  size.  Both 
an  arithmetic  and  a  logarithmic  set  of  these  parameters 
are  calculated,  where  the  logarithmic  values  are  deter¬ 
mined  by  first  taking  the  log  base  10  of  each  monthly 
flow  then  applying  the  statistical  operations.  The  loga¬ 
rithmic  terms  make  it  possible  for  the  user  to  fit 
distribution,  other  than  the  log-normal,  to  the  data. 
The  coefficient  of  variation  compares  the  relative 
amounts  of  variation  in  populations  having  different 
means  and  is  the  standard  deviation  expressed  as  a 
percent  of  the  mean.  Also,  the  skew  is  calculated, 
indicating  if  the  curve  is  a  normal  distribution  or  if 
either  tail  of  the  curve  is  drawn  out  more  than  the  other. 
A  positive  skew  means  that  there  is  a  tail  toward  higher 
values  and  the  median  is  less  than  the  mean.  A  nega¬ 
tive  skew  means  that  there  is  a  tail  toward  the  smaller 
values  and  the  median  is  greater  than  the  mean. 

4.  A  lag  one  correlation  coefficient  is  where  the  values 
denote  how  the  flows  in  the  previous  month  correlate 
with  those  of  the  present  month.  If  the  coefficient  is 
close  to  one,  then  knowledge  of  flows  in  previous 
months  tells  us  the  flow  for  the  present  month.  If  the 
coefficient  is  zero,  the  flows  in  the  two  months  are 
independent  events.  (For  further  explanation  of  the  lag 
one  correlation  coefficient  refer  to  Box  and  Jenkins 
1976.) 

1214200000 


Fig.  8,11.  Sample  output  (ZANTS  file)  from  the  SCORTS  program. 
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90/05/29.  NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000  PROGRAM  -  SCORTS 


15.58, 

11. 

MEAN 

MONTHLY 

DISCHARGE 

-  1962 

THRU  1977 

PAGE 

1 

YEAR 

1 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

ANNUAL 

1962 

523,0 

479.0 

715.0 

865.0 

363.0 

243.0 

709,0 

510.0 

568.0 

318.0 

281.0 

197.0 

481.7 

1963 

300.0 

721.0 

748.0 

421.0 

686.0 

314.0 

523.0 

456.0 

394.0 

247 .0 

125.0 

149.0 

421.4 

1964 

315.0 

751.0 

549.0 

668.0 

380.0 

412.0 

533.0 

846.0 

1219.0 

692.0 

439.0 

405.0 

601.0 

1965 

365.0 

56  8.0 

742.0 

920.0 

771.0 

329.0 

637.0 

587.0 

461.0 

222.0 

146.0 

243.0 

497  .4 

1966 

352.0 

475.0 

429.0 

543.0 

275.0 

472.0 

666.0 

798,0 

599.0 

424.0 

120.0 

78.0 

436.9 

1967 

405.0 

605.0 

999.0 

1054.0 

572.0 

389.0 

284.0 

747.0 

771.0 

244.0 

71.0 

73.0 

518.4 

1968 

760.0 

488.0 

996.0 

853.0 

917 .0 

428.0 

479.0 

682.0 

705.0 

221.0 

238.0 

462.0 

600.8 

1969. 

578.0 

736.0 

603.0 

732.0 

201.0 

408.0 

625.0 

1013.0 

764.0 

249.0 

90.0 

401.0 

534.8 

197  0 

413.0 

377.0 

493.0 

713.0 

545.0 

391.0 

523.0 

540.0 

536.0 

182.0 

90.0 

359.0 

429.5 

1971 

364.0 

589.0 

480.0 

938.0 

834.0 

397.0 

444.0 

1054.0 

875.0 

717 .0 

177.0 

208.0 

588.6 

1972 

374.0 

788.0 

537 .0 

651.0 

1125.0 

1250.0 

682.0 

1170.0 

998.0 

733.0 

181.0 

369.0 

735.6 

197  3 

171.0 

392.0 

972.0 

577.0 

219.0 

27  5.0 

353.0 

523.0 

493.0 

162.0 

64.0 

145.0 

363.4 

197  4 

431.0 

574.0 

805.0 

1105.0 

453.0 

670.0 

620.0 

877.0 

1338.0 

725.0 

263.0 

92.0 

664.4 

1975 

51.0 

528,0 

768.0 

919.0 

439.0 

428.0 

279.0 

854.0 

802,0 

564.0 

307 .0 

163.0 

509.7 

1976 

510.0 

962.0 

1556.0 

996.0 

343.0 

244.0 

480.0 

785.0 

645.0 

491.0 

323.0 

157.0 

627.8 

1977 

153.0 

383.0 

485.0 

500.0 

325.0 

332.0 

605,0 

535.0 

439.0 

142.0 

141.0 

262.0 

358.5 

90/05/29.  NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000  PROGRAM  *  SCORTS 

15.58.11.  MEAN  MONTHLY  DISCHARGE  -  1962  THRU  1977  PAGE  2 


LOG- 

■NORMAL  DISTRIBUTION 

MONTH 

Q90 

Q67 

Q50 

Q33 

QIO 

Q50-Q10 

1 

747.8 

433.4 

329.1 

249.9 

144.8 

184.3 

2 

808.1 

639.4 

568.2 

504.9 

399.5 

168.7 

3 

1092.5 

812.1 

699,2 

602.0 

447.5 

251.7 

4 

1082.6 

848.7 

750.6 

663.9 

520.5 

230.2 

5 

901.6 

582.9 

467.8 

375.3 

242.7 

225.1 

6 

663.9 

473.2 

398.9 

336.3 

239.7 

159,2 

7 

741.1 

577 .0 

508.6 

448.2 

349.0 

159.6 

8 

1043.4 

815.4 

720.0 

635.7 

496.8 

223.2 

9 

1078.9 

795.5 

682.1 

584 . 8 

431.2 

250.9 

10 

713.1 

435.0 

338.9 

264.1 

161.1 

177 .8 

11 

344.3 

210.5 

164.2 

128.1 

78.3 

CO 

12 

432.4 

260.5 

201.7 

156.2 

94.1 

107.6 

ANNUAL 

67  0.3 

560.9 

512.6 

468.5 

392.0 

120.6 

STATISTICAL 

PARAMETERS 

ARITHMETIC 

LOGARITHMIC 

MONTH 

QMEAN  COEF . 

VAR. 

STD  DIV 

XMEAN  COEF .  VAR , 

VARIANCE 

SKEW 

1 

379.6 

0.491 

186.4 

2.51731 

0.11046 

0.07732 

-1.80239 

2 

588.8 

0.282 

166.1 

2.75449 

0.04332 

0.01424 

0.15990 

3 

742.6 

0.388 

288.0 

2.84461 

0.05314 

0.02285 

0.62838 

4 

778.4 

0.246 

191.6 

2.87543 

0.04314 

0.01539 

-0.53946 

5 

528.0 

0.514 

271.4 

2.67002 

0.08326 

0.04943 

0.04197 

6 

436 .4 

0.549 

239.5 

2.60087 

0.06635 

0.02978 

1.59841 

7 

527.6 

0.261 

137.9 

2.70634 

0.04714 

0.01627 

-1.05466 

8 

748.6 

0.286 

213.7 

2.85730 

0.04399 

0.01580 

0.00256 

9 

725.4 

0.309 

224.0 

2.83382 

0.05482 

0.02413 

0.35356 

10 

395.8 

0.551 

218 . 1 

2.53013 

0.09958 

0.06348 

0.12665 

11 

191.0 

0.846 

161.6 

2.21533 

0.11322 

0.06291 

-0.03853 

12 

235.2 

0.700 

164.5 

2.30473 

0.11209 

0.06674 

-0.29397 

ANNUAL 

523.1 

0.453 

237.1 

2.70981 

0.03353 

0.00826 

-0.16909 

MONTH 

LAG  ONE  CORRELATION 

LOG 

COEFFICIENTS 

ARITHMETIC 

1 

0.14 

0.02 

2 

0.27 

0.22 

3 

0.28 

0.37 

4 

0.42 

0.47 

5 

0.19 

0.13 

6 

0.41 

0.53 

7 

0.20 

0.28 

8 

0.00 

0.05 

9 

0.76 

0.82 

10 

0.75 

0.97 

11 

0.61 

0.39 

12 

0.20 

0.09 

SAMPLE  SIZE:  16  YEARS 
STATION  ID:  12142000 


Fig.  8.12.  Sample  output  (ZOUT  file)  from  the  SCORTS  program. 


SELMTS  Program 


163 


SELMTS  Program 


Introduction 

The  SELMTS  program  allows  selection  of  individual 
months  or  groups  of  months  from  two  or  more  monthly 
time  series  data  files  to  create  a  single,  composite  monthly 
time  series  file. 

Suppose,  for  example,  you  had  three  sets  of  habitat 
criteria  for  adults — one  covering  summer  (ADULTSUM), 
one  for  winter  (ADULTWIN),  and  one  for  spring  and  fall 
(ADULTS-F).  The  HABTAE  program  has  produced  three 
habitat-versus-flow  files  and  so  the  HABTS  or  HABNET 
program  has,  in  turn,  generated  three  monthly  time  series 
files.  However,  only  certain  months  from  each  file  are 
valid.  SELMTS  is  a  way  of  selecting  the  appropriate 
months  from  each  of  the  three  files  with  a  resultant  single 
time  series  file  that  represents  adults  all  year. 

Running  SELMTS 

RSELMTS,  ZMTSN,  ZMTS 

ZMTSN  *  New  monthly  time  series  file  in  the  same 
format  as  the  input  files  (output). 

ZMTS  =  A  base  monthly  time  series  file  to  be  used 
as  a  building  block;  can  be  multirecord 
(input). 


Note:  User  will  be  prompted  to  enter  filenames  for 
other  ZMTS  files  to  select  months  from.  All 
input  files  must  be  in  the  same  format  (USGS 
or  NWDC),  contain  the  same  number  of  years, 
and  begin  with  the  same  month. 


You  will  be  given  a  brief  explanation  of  what  the  pro¬ 
gram  is  designed  to  do  and  how  input  files  are  treated;  then 
you  will  be  instructed  to  press  <CR>  to  continue. 

The  title  lines  of  the  base  monthly  time  series  file  to  be 
used  as  a  building  block  will  be  displayed  to  verify  that 
this  is  the  correct  file.  This  filename  was  specified  when 
the  program  was  initiated. 

ENTER  TWO  TITLE  LINES  FOR  THE: NEW  FILE: 


Enter  two  title  lines  for  the  output  file. 

ENTER  INDEX  FOR  FIRST  MONTH  ON  DATA  SET  (E“FEB,,  ETC.) 
(OR  H  FOR  HELP)  ; 


This  index  will  label  the  first  data  entiy  on  the  input  data 
file(s)  with  the  corresponding  month  name.  For  example, 
if  the  first  entry  on  the  data  file(s)  is  January,  enter  1 .  If  the 
first  entry  on  the  data  file(s)  is  October,  enter  10. 

A  table  like  the  one  below  will  appear  to  show  what 
SELMTS  will  use  as  a  yearly  set-up.  A  help  screen  is  also 
available. 

Example: 

Enter  index  for  first  month  on  data  set  (2  =  Feb.,  etc.):  10 

Month  ONDJFMAMJJAS 

ADULTSUM  XXXXXXXXXXXX 


SELECT  MONTHS  FROM  FILES: 

2-^NTBR  FILE  NAME  PROM  WHICH  TO  SELECT  MONTHS  FRCW 
•3-«UlT  SELECTING  MONTHS  FROM  PILES 
AND  CREATE  NEW  PILE 
ENTER  OPTION; 


If  2  is  selected,  the  following  prompt  will  appear.  Re¬ 
member:  All  files  must  be  in  the  same  format,  contain  the 
same  number  of  years,  and  begin  with  the  same  month. 


ENTER  NAME  OP  PILE  TO  SELECT  MONTHS  FROM: 


This  file  is  one  from  which  you  wish  to  select  values  to 
substitute  for  those  in  the  base  file. 


ON  LINE  tWDER  THE  MONTH  (S)  VOV  WANT  TO  USE  FROM  FILE  — ] 
ENTER  an  X  (oi  enter  H  for  help) _ 

To  select  which  month(s)  to  use  from  the  input  file 
specified,  enter  x  or  X  directly  beneath  the  desired  months. 
Typing  H  will  give  a  further  description  of  this  step  and 
then  return  you  to  this  point  for  selection  of  month(s).  Any 
entry  besides  x,  X,  h,  or  H  will  be  ignored.  Do  not  use  the 
TAB  key  or  arrows  to  move  between  months — do  use  the 
space  bar  to  guarantee  proper  information  entry. 

After  selection  of  months  from  the  current  input  file,  you 
will  be  shown  a  summary  of  the  base  file,  input  files,  and 
months  chosen  from  each  up  to  this  point  to  ensure  it  is 
what  you  want.  If  two  or  more  files  have  an  x  in  a  common 
month,  the  last  one  on  this  list  will  be  used.  This  is  one  way 
to  overcome  an  error  in  the  input  without  starting  over. 

The  preceding  prompt  will  be  asked  again.  Answer  it 
according  to  your  needs  and  continue  as  directed  on  the 
screen. 


164 


Biolcxjical  Report  90  (16) 


Example: 

Chi  line  under  the  month(s)  you  want  to  use  from  file 
ADULTWIN  enter  an  X  (or  enter  H  for  help) 

Month  ONDJFMAMJJAS 

ADULTSUM  XXXXXXXXXXXX 

ADULTWIN  X  X  X  X 


Month  ONDJFMAMJJAS 

ADULTSUM  XXXXXXXXXXXX 

ADULTWIN  X  X  X  X 

Select  months  from  files: 

1 —  ^Help, 

2 —  ^Biter  file  name  to  select  months  from 

3 —  Quit  selecting  months  from  files  and  create 
new  file. 


Baicv  option:  2 


Enter  name  of  file  from  which  to  select  months: 
ADULTF-S 

On  line  under  the  month(s)  you  want  to  use  from  file 
ADULTF-S  enter  an  X  (or  enter  H  for  help) 

Month  ONDJFMAMJJAS 

ADULTSUM  XXXXXXXXXXXX 

ADULTWIN  X  X  X  X 

ADULTF-S  XX  XX 

Month  ONDJFMAMJJAS 

ADULTSUM  XXXXXXXXXXXX 

ADULTWIN  X  X  X  X 

ADULTF-S  XX  XX 

Select  months  from  files: 

1 —  ^Help, 

2 —  ^Enter  file  name  to  select  months  from 

3 —  Quit  selecting  months  from  files  and  create 
new  file. 

Enter  option:  3. 
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Chapter  9. 

Generation,  Analysis,  and  Display  of  the  Time  Series  of 
Annual  Habitats 


Introduction 


The  programs  used  to  develop  an  annual  habitat  time 
series  are  based  on  the  monthly  time  series  of  physical 
habitats.  There  are  three  approaches  to  using  annual  habi¬ 
tats:  first,  the  use  of  the  annual  adult  habitat  time  series  for 
each  life  stage.  This  approach  assumes  that  the  time  series 
for  adults  represents  the  year-to-year  variation  of  the  worth 
of  the  stream  for  a  species  of  aquatic  animal.  The  second 
approach  is  the  use  of  the  annual  equivalent  adult  habitat 
time  series.  This  approach  assumes  that  each  year  is  inde¬ 
pendent  of  the  preceding  year,  but  that  each  life  stage  must 
be  considered.  The  third  is  the  use  of  annual  effective  adult 
habitat  time  series.  This  approach  does  not  assume  that 
each  year  is  independent  of  the  preceding  year. 

The  use  of  the  annual  adult  habitat  time  series  makes  the 
assumption  that  the  changes  in  the  adult  physical  habitat 
are  the  habitat  values  to  use  in  the  comparison  of  the 
changes  in  the  habitat  resulting  from  changes  in  water 
management.  This  assumption  is  reasonable  when  the 
habitat  for  life  stages  other  than  adults  is  relatively  larger 
than  the  habitat  for  adults.  The  ANNTS  program  is  used 
to  calculate  the  annual  adult  habitat  time  series  from 
monthly  habitats. 

The  second  approach,  using  equivalent  adult  habitat,  is 
useful  when  the  analyst  is  uncertain  about  the  year-to-year 
interactions.  The  equivalent  adult  habitat  is  based  on 
monthly  habitats  calculated  using  the  equation 


HAE(i,y)  =  min 


where 

n  =  the  number  of  life  stages  being  used  in 
the  analysis  for  the  species  of  interest, 

k  =  the  life  stage, 

i  =  the  month, 

j  =  the  year, 

HA(i,y,  k)  =  the  physical  habitat  for  month  i  in  year  j 
for  life  stage  and 

m{k)  =  an  equivalent  adult  multiplier  for  life 
stage  k. 

The  ANEQTS  program  is  then  used  to  calculate  the  annual 
equivalent  adult  habitat  time  series. 

The  third  approach,  using  effective  adult  habitat,  is  the 
preferred  approach  and  is  appropriate  when  there  is 
adequate  data  and  when  there  is  an  understanding  of 
year-to-year  interactions.  The  annual  effective  adult  habi¬ 
tat  considers  events  in  previous  years  and  uses  the  annual 
time  series  for  each  life  stage.  See  Waddle  (1990b)  for 
information  on  the  logic  behind  effective  adult  habitat 
analysis.  There  are  currently  two  programs  to  calculate  the 
annual  effective  adult  habitat  time  series  (EFFHAB  and 
EFFHB2),  each  of  which  supports  a  different  life  histoiy 
configuration. 

Figure  9. 1  diagrams  the  flow  of  information  through  the 
annual  time  series  programs. 
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Annual  habitat  time  series  generation 


Fig.  9.1.  Flow  of  information  through  the  annual  time  series  programs. 


Annual  Time  Series  Generation 
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Annual  Time  Series  Generation 


Program  Batch/Procedure 
Name  Filename  Rmction 

ANNTS  RANNTS  Annual 

time  series 
generaticxi 


_ Rogram  I>escripdon _ 

Creates  an  annual  time  series  file  from  a  set  of  monthly  time  series 
data.  It  also  produces  an  output  file  containing  tables  and  plots  of  the 
composite,  minimum,  and  maximum  yearly  time  series  values  and  a  ta¬ 
ble  showing  duration  data  for  the  composite  indices. 


RANNTS,  ZMTS,  ZOUT,  ZANTS 


ZMTS  =  Monthly  time  series  file  in  USGS  or  NWDC  format;  can 
be  a  multirecord  file.  Usually  output  from  HABTD  or 
HABTS  (input). 

ZOUT  =  ANNTS  results  (output). 


ZANTS  =  Annual  time  series  file  (output). 


Annual  Equivalent  Adult  Habitat  Time  Series  Generation 

Program  BatdVProcedure 
Name  Filename 

ANEQTS  RANEQTS 


ZHAQF  =  Habitat  area-versus-streamflow  file  for  one  species  with 
up  to  five  life  stages;  caimot  be  a  multirecord  file  (input). 

ZMONQ  “  Monthly  streamflow  file  in  USGS  or  NWDC  format; 
cannot  be  a  multirecord  file  (input). 


Rmction 

Annual 
equivalent 
adult  time  series 
generation 


Program  Description 


Computes  monthly  and  annual  equivalent  adult  habitat  time  series  for 
one  species  with  up  to  five  life  stages. 

RANEQTS,  ZHAQF,  ZMONQ,  ZOUT,  ZMTS,  ZANTS 


ZOUT  =  ANEQTS  results,  including  tables  and  plots  (output). 

ZMTS  =  Monthly  time  series  file  containing  equivalent  adult 
habitat  values  (output). 

ZANTS  =  Annual  time  series  file  containing  composite,  minimum, 
and  maximum  equivalent  adult  habitat  values  for  each 
year  (output). 
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Annual  Effective  Adult  Habitat  Time  Series  Generation 

Program  BatdVProceAirc 

Name  Ffloiame  RmcticMi  _ Program  Description _ 

EFEIN  REFETN  Annual  effective  Creates  an  input  file  for  the  EFFHAB  program  from  user  input  or  from 

adult  habitat  four  annual  habitat  time  series  riles, 
time  series 

generatiai  REFUN,  EFHABIN,  ZANTSl,  ZANTS2,  Z  ANTS3,  ZANTS4 

EFHABIN  =  EFFHAB  input  rile  (output). 

ZANTSl  =  Annual  habitat  time  series  rile  for  adults  (input). 

ZANTS2  =  Annual  habitat  time  series  rile  for  spawning  (input). 
ZANTS3  =  Annual  habitat  time  series  rile  for  fry  (input). 

ZANTS4  -  Annual  habitat  time  series  rile  for  juveniles  (input). 

Note:  Input  riles  must  contain  the  same  number  of  years  of 
data  and  carmot  be  multirecord  riles. 

EFFHAB  REFFHAB  Annual  effective  Calculates  an  effective  adult  habitat  time  series  for  four  life  stages  of  a 

adult  habitat  given  species, 

time  series 

goieraticMi  REFFHAB,  EFHABIN,  ZANTS,  ZOUT 

EFHABIN  =  EFFHAB  input  rile  created  by  the  EFFIN  program  (in¬ 
put). 

ZANTS  =  Annual  time  series  rile  containing  available  and  effective 
adult  habitats  (output). 

ZOUT  =  List  of  data  and  a  table  of  equivalent  adult  habitats,  avail¬ 
able  equivalent  adult  habitat  used,  beginning  of  the  year 
adults,  and  the  effective  habitat  time  series  (output). 


Annual  Effective  Adult  Habitat  Time  Series  Generation 
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Program  Batch/Procedure 
Name  Filename  Rmction 

EFFIN2  REFFIN2  Annual  effective 

adult  habitat 
time  series 
generation 


_ Program  Description _ 

Creates  an  input  file  for  the  EFFHB2  program  from  user  input  or  from 
four  or  five  annual  habitat  time  series  files. 

REFFIN2,  EFHBIN2,  ZANTSl,  ZANTS2,  ZANTS3,  ZANTS4, 
ZANTS5 


EFHBIN2  =  EFFHB2  input  file  (output). 

ZANTSl  =  Annual  habitat  time  series  file  for  adults  (input). 
ZANTS2  =  Annual  habitat  time  series  file  for  spawning  (input). 
ZANTS3  =  Annual  habitat  time  series  file  for  fry  (input). 

If  five  input  files  are  being  used: 

ZANTS4  =  Annual  habitat  time  series  file  for  second  fry  age  class 
(input). 

ZANTS5  Annual  habitat  time  series  file  for  juveniles  (input). 

If  four  input  files  are  being  used: 

ZANTS4  =  Aimual  habitat  time  series  file  for  juveniles  (input). 

Note:  Input  files  must  contain  the  same  number  of  years  of 
data  and  cannot  be  multirecord  files. 


EFEHB2  REFFHB2  Annual  effective  Calculates  an  effective  adult  habitat  time  series  for  four  life  stages 

adult  habitat  with  up  to  two  age  classes  for  fry  and  up  to  three  age  classes  for 

time  series  juvenile. 

generaticm 

RErFHB2,  EFHBIN2,  ZANTS,  ZOUT 

EFHBIN2  =  EFFHB2  input  file  created  by  the  EFFIN2  program  (in¬ 
put). 

ZANTS  =  Annual  time  series  file  containing  available  and  effective 
adult  habitats  (output). 

ZOUT  =  List  of  data  and  a  table  of  equivalent  adult  habitats,  avail¬ 
able  equivalent  adult  habitat  used,  beginning  of  the  year 
adults,  and  the  effective  habitat  time  series  (output). 
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Program 

Name 

LPTDAN 


Analysis  and  Display  of  Annual  Time  Series  Data 

Bald^Prccedute 

Filoiame  Rmctim  _ Program  Description _ 

RLPTDAN  Analyzingand  Reads  cme  or  two  annual  time  series  files  and  writes  an  output  file  con- 

displaying  taining  an  annual  duration  table  showing  ordered  annual  data, 

annual  time  a  summary  statistics  table  containing  average,  median,  index-A,  index- 

smes  data  B,  index-C,  10%,  20%,  80%,  and  90%  exceedence,  and  an 

exceedence  plot. 

RLPTDAN,  ZOUT,  Z  ANTS,  Z  ANTS2 
ZOUT  =  LPTDAN  results  (output). 

ZANTS  =  Annual  time  series  file  (input). 

ZANTS2  =  Second  annual  time  series  file  (input). 


Note:  Input  files  do  not  have  to  contain  the  same  number  of 
years.  Multirecord  files  may  be  used. 


ANEQTS  Program 
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ANEQTS  Program 


Introduction 

The  ANEQTS  program  computes  monthly  and  annual 
equivalent  adult  habitat  time  series  data  for  one  species 
with  up  to  five  life  stages.  This  approach  assumes  that  each 
year  is  independent  of  the  preceding  year,  but  that  each  life 
stage  must  be  considered.  Using  equivalent  adult  habitat 
is  useful  when  the  analyst  is  uncertain  about  the  year-to- 
year  interactions. 

The  decision  equation  used  is 

HAE  =  min[(HAA*WA),  (HAJ*WJ),  (HAF*WF), 
(HAS*WS)] 

where: 

HAE  =  equivalent  adult  habitat, 

HAA  =  monthly  adult  habitat, 

HAJ  ***  monthly  juvenile  habitat, 

HAF  =  monthly  fry  habitat, 

HAS  =  monthly  spawning  habitat, 

WA  =  1.0, 

WJ  =  multiplier  to  adjust  juvenile  habitat  to 
represent  the  adult  habitat  needed  if  all 
the  juvenile  habitat  was  utilized, 

WF  =  same  as  WJ  but  for  fry,  and 

WS  =  same  as  WJ  but  for  spawning. 

Only  the  month  a  life  stage  is  relevant  is  used  in  the 
equation.  For  example,  spawning  may  be  applicable  from 
June  through  September  and  will  only  be  considered  for 
those  months. 

Running  ANEQTS 

RANEQTS,  ZHAQF,  ZMONQ,  ZOUT,  ZMTS, 

ZANTS 

ZHAQF =  Habitat  area-versus-streamflow  file  for 
one  species  with  up  to  five  life  stages; 
cannot  be  a  multirecord  file  (input). 

ZMONQ  «  Monthly  streamflow  file  in  USGS  or 
NWDC  format;  cannot  be  a  multirecord 
file  (input). 

ZOUT  =  ANEQTS  results,  including  tables  and 
plots  (output). 


ZMTS=  Monthly  time  series  file  containing 
equivalent  adult  habitat  values  (output). 

ZANTS  =  Annual  time  series  file  containing  com¬ 
posite,  minimum,  and  maximum  equiva¬ 
lent  adult  habitat  values  for  each  year 
(output). 

The  title  lines  from  the  input  files  will  be  displayed  to 
help  the  user  verify  that  the  correct  files  are  being  used. 


larrER  i  for  likear  interpoiation.  z  for  nonlinear. 


Choose  between  linear  and  nonlinear  transformation  of 
the  streamflow  time  series  into  a  habitat  time  series. 

If  2  was  selected  for  nonlinear  interpolation,  the 
following  prompt  will  appear: 


ENTER  1  FOR  LINEAR  TAILS,  2  FOR  W<m.INEAR. 


How  values  in  the  habitat-versus-flow  file  that  ate  smaller 
than  the  lowest  or  greater  than  the  highest  flows  in  the  flow 
time  series  file  are  considered  tail  flows.  Habitat  values  for 
these  tail  flows  must  be  extrapolated.  Indicate  whether  this 
extrapolation  should  be  linear  or  nonlinear.  Nonlinear  ex¬ 
trapolation  could  give  negative  or  irrational  results  and  you 
should  know  how  to  handle  this  problem  before  you  select 
this  option. 


ENTER  INDEX  FOR  FIRST  MONTH  OF  TIME  SERIES  DATA 
{JAN.^1,  0CT.=»1P^  ETC.) 


Enter  the  number  of  the  first  month  that  appears  in  the 
monthly  flow  time  series  file.  The  program  will  then  be  able 
to  label  the  months  for  output. 


ENTER  FIRST  AND  LAST  VALID  MONTHS  FOR  ( - ) 

OCT.^10,  ETC.) 


The  ANEQTS  program  goes  through  all  life  stages  it 
encounters  in  the  habitat-versus-flow  input  file  and  asks 
which  months  are  relevant  for  the  life  stage.  Enter  the 
months,  separated  by  a  space,  comma,  or  carriage  return. 

LIFE  STAGE  MULTIPLIER  FOR  { - It 


For  each  life  stage,  ANEQTS  needs  to  know  the  multiplier 
to  adjust  the  habitat  to  represent  the  adult  habitat  needed  if 
all  the  habitat  were  utilized. 


ENTER  INDEX  FOR  FIRST  MONTH  OF  BIOLOGICAL  YEAR  . 
{JAH.^1,  OCT. ^10,  ETC.)^ 
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The  number  entered  in  response  to  this  prompt  should 
be  the  month  in  which  fry  hatch  (the  beginning  of  the 
biological  year).  Incomplete  water  years  will  get  dropped. 

Habitat  averages  and  coefficients  of  variance  will  appear 
on  the  screen  (also  written  to  the  output  file)  for  the 
composite,  minimum,  and  maximum  equivalent  adult 
habitat  values.  The  composite  (at  this  time)  is  the  simple 
average  for  the  relevant  months. 

ENTER  a  rm  >L0T5  or  ADOLT  EgUtVALBtrr  habitat  VAttJES 
X  TO  PXOT  HABITAT  VALUES  OW  THE  SCREEN 
.  2  TO  PLOT  HABITAT  VALUES  ON  THE  20UT  FILE 
_ 2  TO  PLOT  HABITAT  VALUES  ON  BOTH. _ 

The  calculated  composite,  minimum,  and  maximum 
equivalent  adult  habitat  values  may  be  plotted  using  bar 
graphs. 


DATE  -  90/06/06.  SNOQUALMIE  RIVER 

TIME  -  12.21.09.  NEAR  SNOQUALMIE  FALLS,  WA 


Figure  9.2  contains  sample  output  from  the  ZOUT  file 
from  ANEQTS.  The  ZOUT  file  contains  (1)  a  copy  of 
the  habitat-versus-flow  file  used  as  input;  (2)  a  copy  of 
the  monthly  time  series  file  used  as  input;  (3)  the  monthly 
habitat  time  series  data  for  each  life  stage  of  the  species 
being  analyzed;  (4)  the  monthly  equivalent  adult  habitat 
time  series  for  the  species  being  analyzed;  (5)  the  com¬ 
posite,  minimum,  and  maximum  equivalent  adult  habitat 
time  series  for  the  species;  and  (6)  a  plot  of  the  compos¬ 
ite,  minimum,  and  maximum  equivalent  adult  habitat 
time  series  if  that  option  was  selected. 

Figure  9.3  is  a  monthly  equivalent  adult  time  series 
(ZMTS)  file  from  ANEQTS;  Fig.  9.4  is  a  annual  equiva¬ 
lent  adult  time  series  (ZANTS)  file  from  ANEQTS. 


PROGRAM  -  ANEQTS 
PAGE  -  10 


COMPOSITE  ADULT  EQUIVALENT  HABITAT  VALUE  FOR  RAINBOW  TROUT 
-  JUNE  THRU  MAY 


1962 

11184.08 

1963 

10526.68 

1964 

11818.50 

1965 

10831.51 

1966 

10339.24 

1967 

10198.48 

1968 

11099.83 

1969 

11594.71 

1970 

10544.68 

1971 

10281.77 

1972 

9898.31 

1973 

10325.97 

1974 

9834.98 

1975 

10256.13 

1976 

11061.11 

COMPOSITE  =  10653.07  C.V.  =  0.0555 


MINIMUM  ADULT  EQUIVALENT  HABITAT  VALUE  FOR  RAINBOW  TROUT 
-  JUNE  THRU  MAY 


1962 

6318.80 

1963 

4045.00 

1964 

8328.12 

1965 

4754.80 

1966 

3830.67 

1967 

3974 . 00 

1968 

6442.20 

1969 

3486.67 

1970 

3486.67 

1971 

5710.80 

197  2 

5528.40 

1973 

4232.00 

1974 

3429.33 

1975 

5285.20 

1976 

4981.20 

COMPOSITE  =  4922.26  C.V.  =  0.2806 


MAXIMUM  ADULT  EQUIVALENT  HABITAT  VALUE  FOR  RAINBOW  TROUT 
-  JUNE  THRU  MAY 


1962 

13595.60 

1963 

13567.60 

1964 

13469.60 

1965 

13539.60 

1966 

13458.40 

1967 

13532.80 

1968 

13441.60 

1969 

13638.80 

1970 

13559.20 

1971 

13556.40 

1972 

13595.60 

1973 

13585.80 

1974 

13581.60 

197  5 

13609.60 

1976 

13660.00 

COMPOSITE  =  13559 

.48 

C.V. 

=  0. 

,0047 

Fig.  9.2.  Sample  output  (2X)UT  file)  from  the  ANEQTS  program.  Only  the  composite,  minimum,  and  maximum  equivalent  adult 
habitat  time  series  data  (in  tabloid  and  plotted  form)  are  included. 
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DATE  -  90/06/06.  SNOQUALMIE  RIVER 

TIME  -  12.21.09.  NEAR  SNOQUALMIE  FALLS,  WA 


PROGRAM  - 
PAGE 


COMPOSITE  ADULT  EQUIVALENT  HABITAT  VALUES  FOR  RAINBOW  TROUT 

-  JUNE  THRU  MAY 

0  2000  4000  6000  8000  10000  12000  14000 

1962  - — - 

1963  - — - 

1964  - - - - - - - - 

1965  - — - 

1966  - — - - - 

1967  - — - 

1968  - - - - — — - 

1969  - — - - — 

1970  - - - — - 

1971  - — - - 

1972  - — - 

1973  - — - - 

1974  - — - 

1975  - — - — 

1976  - - - - 

0  2000  4000  6000  8000  10000  12000  14000 

MINIMUM  ADULT  EQUIVALENT  HABITAT  VALUES  FOR  RAINBOW  TROUT 

-  JUNE  THRU  MAY 

0  2000  4000  6000  8000  10000  12000  14000 

1962  - 

1963  - 

1964  - — 

1965  - 

196  6  - 

1967  - 

196  8  - — - 

1969  - 

197  0  - 

1971  - 

1972  - 

197  3  - 

1974  - 

1975  - 

1976  - 

0  2000  4000  6000  8000  10000  12000  14000 


ANEQTS 
-  11 


Fig.  9.2.  Continued 
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NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000 


ADULT  EQUIVALENT  INDEX  -  RAINBOW  TROUT 


12142000 

1962 

1 

13596 

13437 

12437 

10810 

10972 

7795 

12142000 

1962 

2 

12486 

13632 

13470 

9766 

8882 

6319 

12142000 

1963 

1 

9410 

12388 

12166 

12823 

12675 

9687 

12142000 

1963 

2 

13596 

13194 

12336 

7923 

4045 

4856 

12142000 

1964 

1 

9707 

12142 

13523 

12822 

11720 

12727 

12142000 

1964 

2 

13568 

11082 

8328 

12626 

13013 

12653 

12142000 

1965 

1 

11060 

13470 

12216 

10024 

11978 

9984 

12142000 

1965 

2 

13077 

13416 

13247 

7118 

4755 

7795 

12142000 

1966 

1 

10488 

13395 

12907 

13540 

8715 

13363 

12142000 

1966 

2 

12839 

117  56 

13383 

12854 

3876 

3831 

12142000 

1967 

1 

12653 

13339 

8894 

8744 

13458 

12116 

12142000 

1967 

2 

8965 

12175 

11978 

7827 

4031 

3974 

12142000 

1968 

1 

12068 

13533 

8937 

10982 

10067 

12897 

12142000 

1968 

2 

13437 

12708 

12519 

7086 

7634 

13257 

12142000 

1969 

1 

13442 

12265 

13355 

12298 

6442 

12685 

12142000 

1969 

2 

1317  5 

8847 

12035 

7988 

34  87 

12611 

12142000 

1970 

1 

12738 

11588 

13639 

12453 

13534 

12204 

12142000 

1970 

2 

13596 

13548 

13559 

5863 

3487 

10796 

12142000 

1971 

1 

11016 

13411 

13448 

9767 

11254 

12468 

12142000 

1971 

2 

13066 

8744 

10667 

12421 

5711 

6668 

12142000 

1972 

1 

11456 

11838 

13556 

12962 

8565 

8250 

12142000 

1972 

2 

12708 

8452 

8909 

12289 

5832 

11236 

12142000 

1973 

1 

5528 

12248 

9280 

13444 

7022 

8715 

12142000 

1973 

2 

10532 

13596 

13586 

5255 

4232 

4721 

12142000 

1974 

1 

12929 

13453 

11668 

8615 

13162 

12806 

12142000 

1974 

2 

13216 

10639 

8028 

12355 

8381 

3429 

12142000 

1975 

1 

4605 

13582 

12002 

10038 

13013 

12897 

12142000 

1975 

2 

8826 

10968 

11711 

13481 

9549 

5285 

12142000 

1976 

1 

13610 

9423 

7641 

8937 

10261 

7827 

12142000 

1976 

2 

13448 

11863 

13011 

13565 

9865 

5103 

12142000 

1977 

1 

4981 

12072 

13501 

13660 

9905 

10044 

12142000 

1977 

2 

13339 

13562 

13013 

4620 

4586 

8354 

Fig.  93.  Sample  output  (ZMTS  file)  from  the  ANEQTS  program. 


NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH  1214200000 


ADULT  EQUIVALENT  VALUE  FOR  RAINBOW  TROUT 


A 

12142000 

1962 

11184.1 

6318.8 

13595.6 

A 

12142000 

1963 

10526 .7 

4045.0 

13567.6 

A 

12142000 

1964 

11818.5 

8328 . 1 

13469.6 

A 

12142000 

1965 

10831.5 

4754.8 

13539.6 

A 

12142000 

1966 

10339.2 

3830.7 

13458.4 

A 

12142000 

1967 

10198.5 

3974 . 0 

13532.8 

A 

12142000 

1968 

11099.8 

6442.2 

13441.6 

A 

12142000 

1969 

11594  .7 

3486  .7 

13638.8 

A 

12142000 

1970 

10544 .7 

3486.7 

13559.2 

A 

12142000 

1971 

10281.8 

5710.8 

13556.4 

A 

12142000 

1972 

9898.3 

5528.4 

13595.6 

A 

12142000 

1973 

10326.0 

4232.0 

13585.8 

A 

12142000 

1974 

9835.0 

3429.3 

13581.6 

A 

12142000 

1975 

10256.1 

5285.2 

13609.6 

A 

12142000 

1976 

11061.1 

4981.2 

13660.0 

Fig.  9.4.  Sample  output  (ZANTS  file)  from  the  ANEQTS  program.  The  ZANTS  file  contains  the  composite,  minimum,  and  maxi¬ 
mum  equivalent  adult  habitat  values  for  each  year,  in  that  order. 
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Introduction 

The  ANNTS  program  creates  an  annual  time  series  file 
from  a  set  of  monthly  time  series  data.  It  also  produces  an 
output  file  containing  tables  and  plots  of  the  composite, 
minimum,  and  maximum  yearly  time  series  values  and  a 
table  showing  duration  data  for  the  composite  indices. 

The  monthly  habitat  time  series  files  generated  by  the 
HABTS  and  HABTD  programs  are  commonly  used  as 
input  to  ANNTS.  The  program  calculations  are  listed  in 
the  following  paragraphs. 

Maximum  and  Minimum  Monthly  Indices,  Considering 
only  those  months  designated  by  the  user  for  the  annual 
series,  the  monthly  values  provided  on  the  input  file  are 
searched  for  by  the  ANNTS  program.  The  maximum  and 
minimum  values  for  each  year  are  flagged  and  written  to 
ZOUT  in  a  tabular  and  plotted  format.  In  addition,  these 
values  are  written  to  an  annual  time  series  file  (ZANTS). 

Composite  Index,  Again,  considering  only  those  months 
designated  by  the  user  for  the  annual  series,  each  of  the 
available  monthly  values  provided  in  the  input  monthly 
time  series  (ZMTS)  file  is  multiplied  by  the  number  of 
days  in  the  month.  These  products  are  summed,  and  the 
sum  is  divided  by  the  total  number  of  days  in  the  year,  or 
user-designated  portion  of  the  year,  resulting  in  a  compos¬ 
ite  index  for  each  year  of  data.  The  composite  indices  are 
written  to  ZOUT  in  a  tabular  and  plotted  format.  In  addi¬ 
tion,  they  are  written  to  the  ZANTS  file. 

Duration  for  Composite  Index,  The  composite  indices 
calculated  (in  Composite  Index  section)  are  arranged  in 
descending  order.  The  percent  exceedence  is  calculated 
for  each  value.  A  table  is  then  written  to  ZOUT  contain¬ 
ing  the  year,  the  composite  index  value,  and  the  percent 
exceedence. 

Note  that  in  the  Maximum  and  Minimum  Monthly  In¬ 
dices  and  Composite  Index  section,  the  year  is  designated 
as  that  in  which  the  majority  of  user-designated  months 
reside.  When  the  number  of  months  included  in  the  annual 
calculation  is  split  evenly  between  two  years,  the  later  year 
becomes  the  designated  year. 


Running  ANNTS 

RANNTS,  ZMTS,  ZOUT,  ZANTS 

ZMTS  ==  Monthly  time  series  file  in  USGS  or 
NWDC  format;  can  be  a  multirecord  file 
(input). 

ZOUT  =  ANNTS  results  (output). 

ZANTS  =  Annual  time  series  file  (output). 

The  title  lines  from  the  first  record  in  the  monthly  time 
series  will  be  displayed  to  help  the  user  verify  that  the 
correct  file  is  being  used. 


ENTER  0  FOR  NO  FLOTS  OF  ANNUAL  TIME  SERIES  VALUES 
1  To  FLOT  annual  values  on  the  ZOUT  FILE 
3  TO  FLOT  ANNUAL  VALUES  ON  THE  SCREEN 
3  TO  PLOT  ANNUAL  VALDES  ON  BOTH. 


The  calculated  composite,  minimum,  and  maximum  an¬ 
nual  time  series  values  may  be  plotted  using  bar  graphs. 
The  composite  (at  this  time)  is  the  simple  average  for  the 
relevant  months. 


ENTER  INDEX  FOR  FIRST  MONTH  OF  TIME  SERIES  DATA. 
{aAN.”I>  OCT.“lO,  ETC.)  •  • _ •  ••  - 


Enter  the  number  of  the  first  month  that  appears  in  the 
monthly  time  series  file.  The  program  will  then  be  able  to 
label  the  months  for  output. 


ENTER  FIRST  AND  LAST  VALID  MONTHS  FOR  J  — J 
{JAN.^I,  OCT.^ID^  ETC.} _ 


The  ANNTS  program  goes  through  all  records  it  en¬ 
counters  (usually  life  stages)  in  the  monthly  time  series 
input  file  and  asks  which  months  are  relevant  for  the  record 
(life  stage).  Enter  the  months,  separated  by  a  space, 
comma,  or  carriage  return. 

Figure  9.5  contains  sample  output  from  the  ZOUT  file 
from  ANNTS;  Fig.  9.6  is  an  annual  time  series  (ZANTS) 
file  from  ANNTS. 


176 


Biological  Report  90  (16) 


DATE  -  90/06/06.  SNOQUALMIE  RIVER 

TIME  -  14.21.38.  FRY  RAINBOW  TROUT 


PROGRAM  -  ANNTS 
PAGE  -  2 


COMPOSITE  VALUE  FOR  FRY  RAINBOW  TROUT 

-  JUNE 

THRU  OCT 

1971 

14211.27 

1972 

14561.75 

1973 

16685.02 

1974 

14378.32 

1975 

14737 .67 

1976 

16016.41 

1977 

17336.25 

1978 

17334.05 

1979 

16752.84 

1980 

17028.30 

1981 

15907.09 

MINIMUM  VALUE  FOR 

FRY 

RAINBOW 

TROUT 

-  JUNE 

THRU  OCT 

1971 

9006.00 

1972 

8325.00 

1973 

14600.00 

1974 

7804.00 

1975 

9786.00 

1976 

12494.00 

1977 

15855.00 

1978 

16031.00 

1979 

15320.00 

1980 

15625.00 

1981 

11700.00 

MAXIMUM  VALUE  FOR 

FRY 

RAINBOW 

TROUT 

-  JUNE 

THRU  OCT 

1971 

17841.00 

1972 

18655.00 

1973 

17977.00 

1974 

18474 , 00 

1975 

17229.00 

1976 

18238.00 

1977 

17876.00 

1978 

18622.00 

1979 

17188.00 

1980 

18762.00 

1981 

19105 . 00 

DATE  -  90/06/06. 
TIME  -  14.21.38. 


SNOQUALMIE 

FRY 


RIVER 

RAINBOW  TROUT 


PROGRAM  -  ?^NNTS 
PAGE  -  3 


COMPOSITE  INDEX  FOR  FRY  RAINBOW  TROUT 

-  JUNE  THRU  OCT 


0  3000  6000  9000  12000  15000  18000  21000 


1971 

1972 

1973 

1974 

1975 

1976 

1977 

1978 

1979 

1980 

1981 


0 


3000 

6000 

9000 

12000 

15000 

18000 

21000 

MINIMUM 

INDEX 

FOR  FRY 

RAINBOW 

TROUT 

-  JUNE 

THRU  OCT 

3000 

6000 

9000 

12000 

15000 

18000 

21000 

1971  - 

1972  - 

1973  - 

197  4  - 

1975  - 

1976  - 

1977  - 

1978  - 

1979  - 

19  80  - 

19  81  - 

0  3000  6000  9000  12000  15000  18000  21000 


Fig.  9.5.  Sample  output  (ZOUT  file)  from  the  ANNTS  program.  Ody  the  output  for  Rainbow  trout — ^Fiy  (first  record  in  the  muh 
tirecord  ZMTS  file  used  as  input)  has  been  included. 
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DATE 

TIME  ■ 

■  90/06/06. 

■  14.21.38. 

SNOgUALMIE 

FRY 

RIVER 

RAINBOW  TROUT 

PROGRAM  - 

PAGE 

ANNTS 

4 

MAXIMUM 

INDEX  FOR  FRY 

-  JUNE  THRU  OCT 

RAINBOW  TROUT 

0 

1 

3000 

6000  9000 

12000  15000 

18000 

21000 

1972  - - - 

1973  - - 

1974  - - - 

1975  - - - 

1976  - — — 

1977  - - - 

1978  - — - 

1979  - - - 

1980  - — - 

1981  - — - 

0  3000  6000  9000  12000  15000  18000  21000 


DURATION  DATA  FOR  COMPOSITE  INDEX 


ORDERED  DATA  FOR  1971  THRU  1981  -  FRY  RAINBOW  TROUT 


ORDER 


NUMBER 

YEAR 

ELEMENT 

EXCEEDENC 

1 

1977 

17336.25 

4.55 

2 

1978 

17334 .05 

13.64 

3 

1980 

17028.30 

22.73 

4 

1979 

16752.84 

31.82 

5 

1973 

16685.02 

40.91 

6 

1976 

16016.41 

50.00 

7 

1981 

15907 .09 

59.09 

8 

1975 

14737.67 

68.18 

9 

1972 

14561.75 

77.27 

10 

1974 

14378.32 

86.36 

11 

1971 

14211.27 

95.45 

Fig.  9.5.  Continued. 
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CLASSAl 

SNOQUALMIE 

RIVER 

FRY 

RAINBOW 

TROUT 

A  12142000 

1971 

14211.3 

9006.0 

17841.0 

A  12142000 

1972 

14561.7 

8325.0 

18655.0 

A  12142000 

1973 

16685.0 

14600.0 

17977.0 

A  12142000 

1974 

14378.3 

7804.0 

18474.0 

A  12142000 

1975 

14737.7 

9786.0 

17229.0 

A  12142000 

1976 

16016.4 

12494.0 

18238.0 

A  12142000 

1977 

17336.2 

15855.0 

17876 .0 

A  12142000 

197  8 

17334.1 

16031.0 

18622.0 

A  12142000 

1979 

16752.8 

15320.0 

17188.0 

A  12142000 

1980 

17028.3 

15625.0 

18762.0 

A  12142000 

1981 

15907.1 

11700.0 

19105.0 

#EOR 

CLASSA2 

SNOQUALMIE 

RIVER 

JUVENILE 

RAINBOW 

TROUT 

A  12142000 

1971 

10502.0 

8165.0 

13246.0 

A  12142000 

1972 

9781.7 

7892.0 

13459.0 

A  12142000 

1973 

9421.4 

6166.0 

14240.0 

A  12142000 

1974 

9306.1 

6025.0 

13166.0 

A  12142000 

1975 

10600.1 

7595.0 

12469.0 

A  12142000 

1976 

10850.5 

7163.0 

13878 .0 

A  12142000 

1977 

9571.4 

6922.0 

12536.0 

A  12142000 

1978 

10327.8 

7193.0 

14229.0 

A  12142000 

1979 

9050.7 

5824.0 

14295.0 

A  12142000 

1980 

9793.3 

6585.0 

14608.0 

A  12142000 

#EOR 

CLASSA3 

1981 

9707.1 

5650.0 

13070.0 

SNOQUALMIE 

RIVER 

ADULT 

RAINBOW 

TROUT 

A  12142000 

1971 

8645.2 

5691.0 

12098.0 

A  12142000 

1972 

7855.2 

5479 . 0 

11600.0 

A  12142000 

1973 

7133.3 

4244 . 0 

11776.0 

A  12142000 

1974 

7580.0 

4108.0 

12147 .0 

A  12142000 

1975 

8561.0 

5384.0 

11463.0 

A  12142000 

1976 

8490.2 

5067.0 

11969.0 

A  12142000 

1977 

7094.0 

4701.0 

9908.0 

A  12142000 

197  8 

7690.3 

4899.0 

11148.0 

A  12142000 

1979 

6785.6 

3988.0 

11583.0 

A  12142000 

1980 

7271.8 

4472.0 

11736.0 

A  12142000 
#EOR 

19  81 

7495.5 

3836.0 

11392.0 

Fig.  9.6.  Sample  output  (ZANTS  file)  from  the  ANNTS  program. 
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EFFHAB  Program 


Introduction 

The  EFFHAB  program  calculates  an  effective  adult 
habitat  time  series  for  four  life  stages  of  a  given  species 
by  comparing  habitat  required  with  habitat  available. 
The  program  first  converts  all  available  habitat  data  for 
spawning,  fry,  and  juveniles,  from  the  input  file  created 
by  the  EFFIN  program,  into  adult  equivalent  habitat  area 
using  the  equivalent  adult  habitat  multipliers  (habitat 
ratios)  supplied  in  the  input  file. 

The  EFFIN  and  EFFHAB  programs  make  the  following 
assumptions  regarding  the  data: 

1 .  The  year  begins  with  the  month  the  fish  are  hatched. 
This  is  very  important.  Be  sure  that  the  available 
habitat  data  have  been  calculated  as  such. 

2.  In  the  first  year  of  a  fish’s  life,  or  portion  of  that  year, 
the  fish  is  in  the  fry  stage.  It  lives  the  second  year  of 
its  life  as  a  juvenile.  Beginning  with  the  third  year  of 
its  life  it  is  considered  to  be  an  adult. 

3.  Mortality  is  considered  only  from  year  to  year  in 
adults.  Spawning,  fry,  and  juvenile  mortality  should 
be  taken  into  consideration  in  the  equivalent  adult 
habitat  multipliers. 

4.  All  life  stages  are  initially  at  carrying  capacity;  that 
is,  for  the  first  year,  all  the  available  habitat  is  utilized. 
Thus,  the  first  few  years  of  calculations  will  not  be  as 
accurate  as  later  years. 

EFFHAB  then  begins  calculating  the  effective  adult 
habitat  time  series.  To  calculate  the  effective  adult  habi¬ 
tat  for  year  I  (with  I  >  3),  first  determine  the  adult 
survivors  through  year  I  - 1  by  multiplying  the  effective 
adult  habitat  for  year  I  -  1  by  the  adult  survival  factor. 
Second,  determine  the  recruits  to  adults  at  the  beginning 
of  year  I  by  comparing  the  following  four  values: 


1.  The  effective  adult  habitat  for  year  1-3  (which  deter¬ 
mines  the  number  of  adults  available  for  spawning); 

2.  The  available  habitat  for  spawners  in  year  1-3; 

3.  The  available  habitat  for  fry  in  year  1-2;  and 

4.  The  available  habitat  for  juveniles  in  year  I  -  L 
The  smallest  of  the  above  four  values  comprises  the  re¬ 
cruits  to  adults  at  the  end  of  year  I  - 1  (beginning  of  year 
I).  The  sum  of  the  recruits  to  adults  at  the  beginning  of  year 
I  plus  the  adult  survivors  through  year  I  - 1  (at  the  begin¬ 
ning  of  year  1)  becomes  the  required  adult  habitat  for  year 
I.  The  available  adult  habitat  for  year  I  is  then  compared 
with  the  required  adult  habitat  for  year  I,  and  the  lesser  of 
the  two  values  is  the  effective  habitat  for  year  1. 

Running  EFFHAB 

REFFHAB,  EFHABIN,  ZANTS,  ZOUT 

EFHABIN  =  EFFHAB  input  file  created  by  the  EF¬ 
FIN  program  (input). 

Z ANTS  -  Annual  time  series  file  containing  avail¬ 
able  and  effective  adult  habitats  (output). 

ZOUT  =  List  of  data  and  a  table  of  equivalent 
adult  habitats,  available  equivalent  adult 
habitat  used,  beginning  of  the  year 
adults,  and  the  effective  habitat  time  se¬ 
ries  (output). 

Figures  9.7  and  9.8  contain  sample  output  from  the 
EFFHAB  program. 
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SAMPLE  INPUT  FILE  TO  THE  EFFHAB  PROGRAM  CREATED  BY  THE  EFFIN  PROGRAM 
EFFECTIVE  HABITAT  FOR  GUNNISON  RIVER  BROWN  TROUT  -  ONE  YEAR  JUVENILE 
AVAILABLE  EFFECTIVE 

C  GUNNISON  1980  12049.8  12049.8 

C  GUNNISON  1981  20884.4  4435.6 

C  GUNNISON  1982  23498.0  2506.1 


Fig.  9.7.  Sample  output  (ZANTS  file)  from  the  EFFHAB  program. 


SAMPLE  INPUT  FILE  TO  THE  EFFHAB  PROGRAM  CREATED  BY  THE  EFFIN  PROGRAM 
EFFECTIVE  HABITAT  FOR  GUNNISON  RIVER  BROWN  TROUT  ■  ONE  YEAR  JUVENILE 

ADULT  EQUIVALENT  HABITAT  FACTORS - 

ADULT  SPAWNING  10.000 

ADULT  FRY  8.000 

ADULT  JUVENILE  4.000 

SURVIVAL  FACTOR  0.250 


ADULT  SPAWNING  FRY  JUVENILE 


1980 

12049.8 

4066.0 

245.0 

355.8 

1981 

20884.4 

3144.0 

345.0 

349.3 

1982 

23498.0 

4190.0 

509 . 0 

400.2 

YEAR 

ADULT 

EQUIVALENT 

SPAWNING 

‘  ADULT 

FRY 

JUVENILE 

NEW  ADULT 

END  OF  YEAR 

SURVIVORS 

TOTAL 

EFFECTIVE 

HABITAT 

1980 

12049.80 

40660.00 

1960.00 

1423.20 

1423.20 

3012.45 

4435.65 

12049.80 

1981 

20884.40 

31440.00 

2760.00 

1397.20 

1397 .20 

1108.91 

2506 . 11 

4435.65 

1982 

23498 . 00 

41900.00 

4072.00 

1600.80 

1600.80 

626.53 

2227.33 

2506 . 11 

Fig.  9.8.  Sample  output  (ZOUT  file)  from  the  EFFHAB  program. 
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Introduction 

The  EFFHB2  program  calculates  an  effective  adult  habi¬ 
tat  time  series  for  four  life  stages  with  up  to  two  age  classes 
for  fly  and  up  to  three  age  classes  for  juveniles.  EFFHB2 
calculates  an  effective  adult  habitat  time  series  for  a  given 
species,  assuming  that  the  species’  life  cycle  consists  of 

•  a  fiy  life  stage  for  all  or  part  of  the  first  year,  which 
may  be  divided  into  two  age  classes,  both  existing 
during  the  single  year, 

•  from  one  to  three  juvenile  life  stages  each  existing  for 
one  year  or  portion  of  a  year;  thus,  the  first  juvenile 
life  stage  begins  at  one  year  old,  the  second  juvenile 
life  stage  (which  is  optional)  begins  at  two  years  old, 
and  the  third  juvenile  life  stage  (also  optional)  begins 
at  three  years  old; 

•  an  adult  life  stage  that  begins  at  either  the  second, 
third,  or  fourth  birthday,  depending  on  the  number  of 
juvenile  life  stages  in  existence;  and 

•  a  spavraing  life  stage  that  occurs  for  a  portion  of  each 
adult  year. 

The  EFFIN2  program  creates  an  input  file  for  the 
EFFHB2  program.  The  EFFIN2  and  EFFHB2  programs 
make  the  following  assumptions  regarding  the  data: 

1.  The  year  begins  with  the  month  the  fish  are  hatched. 
TTiis  is  very  important.  Be  sure  that  the  available 
habitat  data  have  been  calculated  as  such. 

2.  In  the  first  year  of  a  fish’s  life,  or  portion  of  that  year, 
the  fish  is  in  the  fry  stage.  It  lives  the  second  year  of 
its  life  as  a  juvenile.  Beginning  with  the  third,  fourth, 
or  fifth  year  of  its  life,  it  is  considered  an  adult. 

3.  Mortality  is  considered  separately  from  year  to  year 
only  in  adults.  Spawning,  fiy,  and  juvenile  mortality 
should  be  taken  into  consideration  in  the  equivalent 
adult  habitat  multipliers. 

4.  All  life  stages  are  initially  at  carrying  capacity.  That 
is,  for  the  first  year,  all  the  available  habitat  is  utilized. 
Thus,  the  first  few  years  of  calculations  will  not  be  as 
accurate  as  later  years. 

An  annual  effective  adult  habitat  time  series  is  calculated 
by  comparing  habitat  area  available  with  habitat  area 
required  by  each  life  stage  or  age  class.  Four  or  five  annual 
available  habitat  time  series  must  therefore  be  provided: 
one  for  adults;  one  for  spawning;  one  for  each  fiy  age  class; 
and  one  for  juveniles.  The  EFFHB2  program  is  designed 
such  that  the  juvenile  life  stages  are  competitive— that  is, 
the  single  juvenile  available  habitat  time  series  is  divided 
among  the  one  to  three  juvenile  life  stages.  Either  the  user 
designates  the  percentage  of  habitat  to  be  allocated  to  each 


juvenile  life  stage  or  the  option  is  available  to  permit  the 
oldest  juvenile  life  stage  all  that  they  require,  in  which  case 
the  middle  juvenile  life  stage  would  take  what  they  require 
fix)m  the  remainder,  and  the  rest  would  go  to  the  yoimgest 
juvenile  life  stage.  This  option  is  also  available  when  only 
two  juvenile  life  stages  exist.  For  the  remainder  of  this 
document,  this  option  will  be  called  the  ‘Recking  order 
option.” 

The  EFFHB2  program  apportions  the  juvenile  habitat 
when  more  than  one  juvenile  life  stage  is  being  used.  This 
is  done  by  straight  percentages  if  the  user  has  so  desig¬ 
nated.  When  the  pecking  order  option  has  been  selected, 
all  the  juvenile  habitat  is  allocated  to  the  oldest,  with  the 
others  getting  none  for  the  present.  The  program  then 
converts  the  four  or  five  available  habitat  time  series,  read 
from  the  input  file  created  by  the  EFFIN2  program,  into 
equivalent  adult  habitat  time  series  by  using  the  equivalent 
adult  habitat  multipliers. 

The  EFFHB2  program  then  begins  calculating  the  effec¬ 
tive  adult  habitat  time  series.  It  should  be  noted  that  all  life 
stages  are  assumed  to  be  at  carrying  capacity  in  the  begin¬ 
ning — that  is,  for  the  first  year  of  calculations,  it  is  as¬ 
sumed  that  all  available  habitat  is  used.  The  following 
paragraph  gives  a  description  of  how  this  assumption  is 
made  for  juveniles  when  the  user  designates  the  pecking 
order  option  described  previously. 

A  starting  point  is  established  for  the  juveniles  when  the 
pecking  order  option  is  chosen  by  calculating  the  juvenile 
habitat  for  each  juvenile  life  stage  that  would  have  been 
required  to  use  all  the  adult  habitat  available  in  the  first 
year.  These  required  quantities  of  habitat  (one  for  each 
juvenile  life  stage)  are  summed,  and  the  sum  is  compared 
with  the  available  juvenile  habitat  for  the  first  year.  When 
the  amoimt  of  available  juvenile  habitat  is  less  than  re¬ 
quired,  the  oldest  life  stage  (or  stages)  is  given  priority  and 
the  youngest  suffers  the  shortage.  When  the  amount  of 
available  juvenile  habitat  is  greater  than  required,  the  extra 
is  allocated  according  to  the  percent  of  total  each  life  stage 
requires. 

In  calculating  the  effective  adult  habitat  time  series,  the 
EFFHB2  program  progresses  year  by  year,  advancing  each 
life  stage  to  the  next  and  comparing  required  equivalent 
adult  habitat  with  available  adult  equivalent  habitat.  From 
year  two  onward,  the  calculations  progress  as  follows: 

1.  The  amount  of  adult  habitat  required  at  the  beginning 
of  the  year  (beginning-of-year  adults)  is  calculated  by 
multiplying  the  effective  adult  habitat  from  the  pre¬ 
vious  year  by  the  survival  factor  and  adding  to  that 
product  the  amount  of  adult  equivalent  habitat  used 
by  the  oldest  juvenile  life  stage  in  the  previous  year. 
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2.  The  effective  adult  habitat  (amount  of  habitat  used  by 
adults  in  the  present  year)  is  designated  as  the  smaller 
of  either  the  available  adult  habitat  for  the  present  year 
or  the  beginning-of-year  adults  calculated  in  step  1 . 

3.  The  required  spawning  habitat  is  set  equal  to  the 
effective  adult  habitat  for  the  present  year  calculated 
in  step  2.  It  is  then  compared  with  the  available 
equivalent  adult  spawning  habitat  for  the  present  year 
and  the  lesser  of  the  two  values  becomes  the  used 
spawning  equivalent  adult  habitat  for  the  present 
year.  Remember  that  the  fish  spawn  at  the  end  of  the 
year  and  are  hatched  in  the  next  year — that  is,  the  new 
year  begins  on  the  fish’s  birthday  for  the  purpose  of 
the  EFFHB2  program. 

4.  The  required  fiy  habitat  (for  the  younger  fry  age 
class)  is  set  equal  to  the  used  spawning  equivalent 
adult  habitat  for  the  previous  year,  which  is  then 
compared  with  the  available  equivalent  adult  fry 
(younger  age  class)  habitat  for  the  present  year  and 
the  smaller  of  the  two  values  becomes  the  used  fry 
(younger  age  class)  equivalent  adult  habitat  for  the 
present  year. 

5.  When  a  second  fiy  age  class  is  being  considered,  the 
required  fry  habitat  (for  the  older  fry  age  class)  is  set 
equal  to  the  used  fry  equivalent  adult  habitat  for  the 
present  year  (calculated  in  step  4).  (Remember  that 
for  the  purpose  of  the  EFFHB2  program,  fry  go 
through  both  age  classes  in  the  same  year.)  This 
number  is  then  compared  with  the  available  equiva¬ 
lent  adult  fry  (older  age  class)  habitat  for  the  present 
year  and  the  lesser  of  the  two  values  becomes  the  used 
fry  (older  age  class)  equivalent  adult  habitat  for  the 
present  year. 

6.  When  the  pecking  order  option  is  selected  and  three 
juvenile  life  stages  are  being  used,  skip  step  6.  The 
required  habitat  for  the  youngest  juvenile  life  stage, 
called  juvenile  1,  is  set  equal  to  the  used  fry  (oldest 
age  class)  equivalent  adult  habitat  for  the  previous 
year.  It  is  then  compared  with  the  available  equivalent 
adult  juvenile  1  habitat  for  the  present  year  and  the 
lesser  of  the  two  values  becomes  the  used  juvenile  1 
equivalent  adult  habitat  for  the  present  year.  If  a 
second  juvenile  life  stage  is  being  considered,  the 
required  habitat  for  this  life  stage,  called  juvenile  2, 
is  set  equal  to  the  used  juvenile  1  equivalent  adult 
habitat  for  the  previous  year.  It  is  then  compared  with 
the  available  equivalent  adult  juvenile  2  habitat  for 
the  present  year,  and  the  lesser  of  the  two  values 
becomes  the  used  juvenile  2  equivalent  adult  habitat 
for  the  present  year.  If  a  third  juvenile  life  stage  is 
being  considered,  the  required  habitat  for  this  life 
stage,  called  juvenile  3,  is  set  equal  to  the  used 
juvenile  2  equivalent  adult  habitat  for  the  previous 
year.  It  is  then  compared  with  the  available  equivalent 


adult  juvenile  3  habitat  for  the  present  year  and  the 
lesser  of  the  two  values  becomes  the  used  juvenile  3 
equivalent  adult  habitat  for  the  present  year.  When 
two  juvenile  life  stages  are  being  used,  if  one  shows 
a  shortage  of  available  habitat  and  the  other  does  not 
use  all  that  it  has  available,  the  extra  is  given  to  the 
one  in  need  and  the  appropriate  used  equivalent  adult 
habitat  is  recalculated.  When  three  juvenile  life 
stages  are  being  used  and  one  of  them  shows  a  short¬ 
age  of  available  habitat,  all  the  extra  is  given  to  the 
one  in  need  and  its  used  equivalent  adult  habitat  is 
recalculated.  When  three  juvenile  life  stages  are  be¬ 
ing  used  and  two  of  them  show  a  shortage  of  available 
habitat,  the  extra  from  the  third  is  divided  between 
the  two  in  proportion  to  the  initial  percentages  the 
user  allocated,  and  the  two  used  equivalent  adult 
habitat  values  are  recalculated.  If  only  one  is  still  in 
need,  any  extra  from  the  other  is  donated,  and  the  one 
used  equivalent  adult  habitat  value  is  calculated  a 
third  time. 

7.  This  step  is  valid  only  when  the  pecking  order  option 
is  selected  using  three  juvenile  life  stages.  The  re¬ 
quired  juvenile  3  (oldest)  habitat  is  set  equal  to  the 
used  juvenile  2  (middle)  habitat  for  the  previous  year. 
It  is  then  compared  with  the  available  equivalent 
adult  juvenile  3  habitat  for  the  present  year  and  the 
lesser  of  the  two  values  becomes  the  used  juvenile  3 
equivalent  adult  habitat  for  the  present  year.  (Re¬ 
member  that  in  this  instance,  the  available  juvenile  3 
habitat  consists  of  all  the  available  juvenile  habitat.) 
When  there  is  no  extra  available  juvenile  3  habitat 
(used  juvenile  3  =  available  juvenile  3),  used  juvenile 
2  and  used  juvenile  1  equivalent  adult  habitat  for  the 
present  year  are  set  equal  to  zero  and  step  7  is  com¬ 
plete.  When  there  is  extra  available  juvenile  3  habitat 
(used  juvenile  3  =  required  juvenile  3),  the  extra  is 
converted  to  available  equivalent  adult  juvenile  2 
habitat  for  the  present  year.  The  required  juvenile  2 
habitat  is  set  equal  to  the  used  juvenile  1  habitat  for 
the  previous  year.  It  is  then  compared  with  the  avail¬ 
able  equivalent  adult  juvenile  2  habitat  for  the  present 
year,  and  the  lesser  of  the  two  values  becomes  the 
used  juvenile  2  equivalent  adult  habitat  for  the  pre¬ 
sent  year.  When  there  is  no  extra  available  juvenile  2 
habitat  (used  juvenile  2  =  available  juvenile  2),  used 
juvenile  1  equivalent  adult  habitat  for  the  present  year 
is  set  equal  to  zero  and  step  7  is  complete.  When  there 
is  extra  available  juvenile  2  habitat  (used  juvenile  2 
==  required  juvenile  2),  the  extra  is  converted  to  avail¬ 
able  equivalent  adult  juvenile  1  habitat  for  the  present 
year.  The  required  juvenile  1  habitat  is  set  equal  to 
the  used  fry  (oldest  age  class)  habitat  for  the  previous 
year.  It  is  then  compared  with  the  available  equivalent 
adult  juvenile  1  habitat  for  the  present  year,  and  the 
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lesser  of  the  two  values  becomes  the  used  juvenile  1 
equivalent  adult  habitat  for  the  present  year. 

Running  EFFHB2 

REFFHB2,  EFBBIN2,  ZANTS,  ZOUT 

EFHBIN2  =  EFFHB2  input  file  created  by  the  EF- 
FIN2  program  (input). 


ZANTS  «  Annual  time  series  file  containing  avail¬ 
able  and  effective  adult  habitats  (output). 

ZOUT  “  List  of  data  and  a  table  of  equivalent 
adult  habitats,  available  equivalent  adult 
habitat  used,  beginning  of  the  year 
adults,  and  the  effective  habitat  time  se¬ 
ries  (output). 

Figures  9.9  and  9.10  contain  sample  output  from  the 
EFFHB2  program. 


SAMPLE  INPUT  FILE  TO  THE  EFFHB2  PROGRAM  CREATED  BY  THE  EFFIN2  PROGRAM 
EFFECTIVE  HABITAT  FOR  GUNNISON  RIVER  BROWN  TROUT  -  ONE -YEAR  JUVENILE 
AVAILABLE  EFFECTIVE 

C  GUNNISON  1964  13049.0  13049.0 

C  GUNNISON  1965  12719.0  12719.0 


Fig.  9.9.  Sample  output  (ZANTS  file)  fi-om  the  EFFHB2  program. 


SAMPLE  INPUT  FILE  TO  THE  EFFHB2  PROGRAM  CREATED  BY  THE  EFFIN2  PROGRAM 
EFFECTIVE  HABITAT  FOR  GUNNISON  RIVER  BROWN  TROUT  -  ONE -YEAR  JUVENILE 

ADULT  EQUIVALENT  HABITAT  FACTORS - 


ADULT  SPAWNING  10.000 
ADULT  SWIMUP  8.000 
ADULT  FINGERLING  4.000 
ADULT  JUVENILE  2.000 

SURVIVAL  FACTOR  0.250 


HABITAT  AVAILABLE  TO  EACH  LIFESTAGE 
ADULT  SPAWNING  SWIMUP  FINGERLING  JUVENILE 


1964 

13049.0 

4063.0 

32.3 

528.0 

12715.0 

1965 

12719.0 

2521.0 

4.8 

173 . 0 

13551.0 

EQUIVALENT  ADULT  HABITAT  AVAILABLE 

BEGINNING  OF 

EFFECTIVE 

YEAR 

ADULT 

SPAWNING 

SWIMUP 

FINGERLING 

JUVENILE 

YEAR  ADULTS 

HABITAT 

1964 

13049.00 

40630.00 

258.40 

2112.00 

25430.00 

-99999,99 

13049 .00 

1965 

12719.00 

25210.00 

38.40 

692.00 

27102.00 

28692.25 

12719.00 

EQUIVALENT  ADULT  HABITAT  USED 

BEGINNING  OF 

EFFECTIVE 

YEAR 

ADULT 

SPAWNING 

SWIMUP 

FINGERLING 

JUVENILE 

YEAR  ADULTS 

HABITAT 

1964 

13049.00 

13049.00 

258.40 

2112.00 

25430.00 

-99999.99 

13049.00 

1965 

12719.00 

12719.00 

38.40 

38.40 

2112.00 

28692.25 

12719.00 

Note:  In  the  last  table,  the  adult  habitat  used  and  the  effective  habitat  are  the  same.  They  will  always  be  the  same 
since  effective  habitat  is  defined  as  usable  adult  habitat. 


Fig.  9.10.  Sample  output  (ZOUT  file)  from  the  EFFHB2  program. 
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EFFIN  Program 


Introduction 

The  EFFIN  program  creates  an  input  file  for  the 
EFFHAB  program  that  calculates  an  effective  adult  habitat 
time  series  for  four  life  stages  of  a  given  species.  Input  to 
EFFIN  is  either  entered  directly  from  the  keyboard  or  read 
from  four  annual  habitat  time  series  (ZANTS)  files.  The 
ZANTS  files  were  created  by  the  ANNTS  program  using 
a  monthly  time  series  file  (ZMTS)  generated  by  the 
HABTD  or  HABTS  programs  as  input. 

If  ZANTS  files  are  being  used  as  input  to  the  EFFIN 
program,  the  first  input  file  should  contain  values  for 
adults;  the  second,  values  for  spawning,  the  third  for  fry, 
and  the  fourth  for  juvenile.  All  four  input  files  must  contain 
the  same  number  of  years  of  data  and  cannot  be  multi¬ 
record  files. 

The  EFFIN  and  EFFHAB  programs  make  the  following 
assumptions  regarding  the  data: 

1 .  The  year  begins  with  the  month  the  fish  are  hatched. 
This  is  very  important.  Be  sure  that  the  available 
habitat  data  have  been  calculated  as  such. 

2.  In  the  first  year  of  a  fish’s  life,  or  portion  of  that  year, 
the  fish  is  in  the  fry  stage.  It  lives  the  second  year  of 
its  life  as  a  juvenile.  Beginning  with  the  third  year  of 
its  life  it  is  considered  to  be  an  adult. 

3.  Mortality  is  considered  only  from  year  to  year  in 
adults.  Spawning,  fry,  and  juvenile  mortality  should 
be  taken  into  consideration  in  the  adult  equivalent 
habitat  multipliers. 

4.  All  life  stages  are  initially  at  carrying  capacity — that 
is,  for  the  first  year,  all  the  available  habitat  is  utilized. 
Thus,  the  first  few  years  of  calculations  will  not  be  as 
accurate  as  later  years. 

Figure  9.11  contains  a  sample  input  file  to  the  EFFHAB 
program  created  by  EFFIN. 


Running  EFFIN 

REFFIN,  EFHABIN,  ZANTSl,  ZANTS2,  ZANTS3, 
ZANTS4 

EFHABIN  =  EFFHAB  input  file  (output). 

ZANTSl  *  Annual  habitat  time  series  files  for  adults 
(input). 

ZANTS2  *  Annual  habitat  time  series  files  for 
spawning  (input). 

ZANTS3  =  Annual  habitat  time  series  files  for  fiy 
(input). 

ZANTS4  =  Annual  habitat  time  series  files  for  juve¬ 
niles  (input). 


Input  files  must  contain  the  same  number  of  years  of 
data  and  cannot  be  multirecord  files. 


ENTER  0  TO  05E  ANNUAL  TIME  SERIES  FILES  AS  INPUT 
1  TO  ENTER  ALL  DATA  FROM  KEYBOARD 


Remember,  if  annual  time  series  files  (ZANTS)  files  are 
being  used  as  input,  they  must  contain  the  same  number  of 
years  and  have  been  entered  in  the  following  order  when 
EFFIN  was  run:  adults,  spawning,  fiy,  juveniles. 

ENTER  TWO  LINE  TITLE: 


Enter  a  2-line  title  for  the  output  file  using  a  maximum 
of  80  characters  per  line. 

. ENTER  THE  ADULT  SURVIVAL  FACTOR; 


The  adult  survival  factor  must  be  between  0.0  and  1.0 
and  remains  constant  throughout  the  program  run. 

ENTER  THE  ADULT  : EQUIVALEMT  HABITAT:  MULTIPLIERS  FOR 
SPAWNING.  FRY,  AND  JUVENILE.  IN  THAT  ORDER:  _ 


SAMPLE  INPUT  FILE  TO  THE  EFFHAB  PROGRAM  CREATED  BY  THE  EFFIN  PROGRAM 
EFFECTIVE  HABITAT  FOR  GUNNISON  RIVER  BROWN  TROUT  -  ONE  YEAR  JUVENILE 
.25  10.00  8.00  4.00 


ADULT 

SPAWNING 

FRY 

JUVENILE 

E 

GUNNISON 

1980 

12049.8 

4066.0 

245 . 0 

355.8 

E 

GUNNISON 

1981 

20884.4 

3144 .0 

345 . 0 

349.3 

E 

GUNNISON 

1982 

23498.0 

4190.0 

509 .0 

400.2 

Fig.  9.11.  Sample  input  file  to  the  EFFHAB  program  created  by  EFFIN. 
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Enter  the  multipliers  separated  by  a  comma,  space,  or 
carriage  return.  These  multipliers  remain  constant  through¬ 
out  the  program  run. 


JENtER  CHAR)  t 


If  annual  time  series  files  were  used  as  input,  the  fol¬ 
lowing  prompts  will  appear  in  addition  to  those  ex¬ 
plained  above: 


DATASET  IS 


The  following  prompts  will  be  repeated  four  times — once 
for  each  input  ZANTS  file.  The  blank  will  show  the  two  title 
lines  fiom  the  input  file  being  considered. 


Renter  o  for  composite 
X  roR  HXNXMOM 

OR  2  FOR  MAXlMtlM  AS  RELEVANT  TIME  SERIES 


This  prompt  refers  to  the  three  columns  of  numbers  on  the 
annual  time  series  file.  The  first  column  is  the  composite 
annual  habitat  value  (average  of  the  maximum  and  mini¬ 
mum  values  for  the  relevant  months).  The  second  and  third 
values  are  the  minimum  and  maximum  annual  habitat  val¬ 
ues,  respectively.  You  must  choose  the  index  appropriate  for 
the  species4ife  stage. 

For  example,  a  maximum  value  for  spawning  is  used 
under  the  assumption  that  the  spawn  will  occur  anytime 
within  a  certain  (temperature-flow)  window.  In  contrast,  a 
minimum  value  may  be  more  appropriate  for  fry,  which  are 
more  vulnerable  to  catastrophic  events.  For  more  resilient 
adults,  an  average  may  be  the  most  appropriate.  In  any  case, 
you  must  choose  a  biologically  reasonable  response. 


ENTER  -  1  TO 'add  A  YEAR;  TO’TOEi 

.  2.  ...T^  EtTOTRACT  A  YEAR  FROM  THE  DATA 

TO  THE  YEARS  UNCHANGED 


This  prompt  allows  you  to  ensure  that  the  annual  index 
applies  to  the  correct  biological  year  (biological  year  is 
defined  as  beginning  with  the  month  of  the  hatch  or 
swimup).  You  are  responsible  for  defining  how  you  wish  to 
numerically  refer  to  a  biological  year  and  making  sure  that 
annual  index  values  are  synchronized  to  each  biological  year 
for  each  interdependent  life  stage.  (This  is  a  challenge — an 
example  follows.) 

Most  monthly  habitat  time  series  analyses  are  performed 
in  a  water  year  format — that  is,  month  1  is  October,  month 
2  is  November,  and  so  forth.  October  of  water  year  1960  is 
really  in  calendar  year  1959.  To  further  complicate  matters, 
the  ANNTS  program  may  have  changed  the  year  designa¬ 
tion  based  on  its  algorithm  of  choosing  the  year  from  the 
greatest  number  of  months  ccxisidered  in  the  annual  index 
calculation. 

Hatch  of  a  theoretical  fall-spawning  species  is  in  March 
and  April.  We  further  assume  that  the  fry  life  stage  may  be 
from  March  through  November,  juvenile  from  December 
through  February,  and  adults  are  present  all  year.  The  bio¬ 
logical  year,  by  definition,  will  be  from  March  to  February. 
In  this  case,  the  fry  habitat  value  from  (calendar  year  [and 
water  year])  1960  matches  the  habitat  value  that  should  be 
used  to  characterize  biological  year  1960.  However,  the 
juvenile  habitat  value  from  (calendar  year  [and  water  year]) 
1960  really  applies  to  biological  year  1959.  This  is  b^use 
the  December  through  February  ^bitat  value  following  the 
hatch  is  in  the  next  water  year.  (In  addition,  ANNTS  would 
have  put  the  habitat  values  into  1960  because  the  majority 
of  months,  January  and  February,  occur  in  calendar  year 
1960.)  Thus,  you  would  need  to  subtract  1  year  from  the 
annual  designation  for  juveniles.  Adults,  present  year  round 
in  our  example,  will  not  need  to  be  changed.  Figure  9.12 
diagrams  this  concept. 

All  this  can  be  confusing.  We  recommend  that  the  output 
from  both  ANNTS  and  EFFIN  be  scrutinized  to  make  sure 
that  the  biological  year  is  properly  characterized  and  all 
life  stages  are  synchronized  before  running  the  EFFHAB 


Water  Year-« - - 1960 _ ^  ^  1961 _ ^ 

Calendar  ^1958  - - 1959 _ _ I960 _ ,  ,1961 

Year 

Biological  , _ 1959  _  _ i960 _ 

Year 

ONDJFMAMJJASONDJFMAMJJA  S  O  N  D  J  F 


Fry 

Juvenile 

Adult 


Fig.  9.12.  Deteimination  of  the  correct  year  number  in  the  EFFIN  and  EFFIN2  programs. 
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program.  You  may  need  to  delete  mismatched  biological 
years  from  certain  life  stages  when  you  have  finished, 
using  a  text  editor.  Totally  illogical  results  are  assured  if 
care  is  not  taken. 


COtiPOSITE  TXtt  WITH  YEARS  WRITTEN. 


The  blank  will  contain  the  number  of  years  of  data 
written  to  the  output  file.  The  output  file  should  now 
ccntain  the  data  in  a  format  that  can  be  read  by  the 
EFFHAB  program. 

If  all  data  is  being  entered  from  the  keyboard,  the 
following  prompts  will  appear  in  addition  to  those 
explained  previously: 


ENTER  FIRST  YEAR  OF  DATA: 


Enter  the  year  number  for  the  first  year  of  data:  example, 
1980. 


ENTER  ANNUAL  HABITAT  DATA: 

tEntei  4  va  lues  fox  oactj  in  f ortna t : 

Separate  aach  valua  with  a  afiace  and  follow  the  fourth  vaXua 

with  a  carriage  return.  Whan  all  years  of  data 

hava  bean  enter ad,  type  Q  to  quit.J 

Year  Adul  fc  Spawning _ Fry _ ilnv^nl  T<a 


[xxxx]  is  the  first  year  number  entered  in  the  prompt 
Enter  first  year  of  data: 
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Introduction 

The  EFFIN2  program  creates  an  input  file  for  the 
EFFHB2  program  that  calculates  an  effective  adult  habitat 
time  series  for  four  life  stages  with  up  to  two  age  classes 
for  fry  and  up  to  three  age  classes  for  juveniles.  EFFHB2 
assumes  that  the  species*  life  cycle  consists  of 

1.  a  fry  life  stage  for  all  or  part  of  the  first  year,  which 
may  be  divided  into  two  age  classes,  both  existing 
during  the  single  year; 

2.  from  one  to  three  juvenile  life  stages,  each  existing 
for  one  year  or  portion  of  a  year;  thus,  the  first 
juvenile  life  stage  begins  at  one  year  old,  the  second 
juvenile  life  stage  (optional)  begins  at  two  years  old, 
and  the  third  juvenile  life  stage  (optional)  begins  at 
three  years  old; 

3.  an  adult  life  stage  begins  at  either  the  second,  third, 
or  fourth  birthday,  depending  on  the  number  of  juve¬ 
nile  life  stages  in  existence;  and 

4.  a  spawning  life  stage  that  occurs  for  a  portion  of  each 
adult  year. 

Input  to  EFFIN2  is  either  entered  directly  from  the 
keyboard  or  read  fi-om  four  or  five  annual  habitat  time 
series  files  (ZANTS).  The  ZANTS  files  are  created  by  the 
ANNTS  program  using  a  monthly  time  series  file  (ZMTS) 
generated  by  the  HABTD  or  HABTS  programs  as  input. 

If  ZANTS  files  are  being  used  as  input  to  the  EFFIN2 
program,  the  first  input  file  should  contain  values  for 
adults,  the  second,  values  for  spawning,  and  the  third, 
values  for  fry.  If  five  ZANTS  files  are  used  as  input,  the 
fourth  file  should  contain  values  for  the  second  fry  age 
class  and  the  fifth  should  contain  juvenile  values.  If  only 
four  ZANTS  files  are  used  as  input,  then  the  fourth  file 
should  contain  values  for  juveniles.  All  four  or  five 
ZANTS  files  must  contain  the  same  number  of  years  of 
data  and  cannot  be  multirecord  files. 

The  EFFIN2  and  EFFHB2  programs  make  the  follow 
assumptions  regarding  the  data: 


1.  The  year  begins  with  the  month  the  fish  are  hatched. 
This  is  very  important.  Be  sure  that  the  available 
habitat  data  have  been  calculated  as  such. 

2.  In  the  first  year  of  a  fish’s  life,  or  portion  of  that  year, 
the  fish  is  in  the  fry  stage.  It  lives  the  second  year  of 
its  life  as  a  juvenile.  Beginning  with  the  third,  fourth, 
or  fifth  year  of  its  life,  it  is  considered  an  adult. 

3.  Mortality  is  considered  separately  from  year  to  year 
only  in  adults.  Spawning,  fiy,  and  juvenile  mortality 
should  be  taken  into  consideration  in  the  adult 
equivalent  habitat  multipliers. 

4.  All  life  stages  are  initially  at  carrying  capacity — that 
is,  for  the  first  year,  all  the  available  habitat  is  used. 
Thus,  the  first  few  years  of  calculations  will  not  be  as 
accurate  as  later  years. 

Figure  9. 13  contains  a  sample  input  file  to  the  EFFHB2 
program  created  by  EFFIN2. 

Running  EFFIN2 

REFFIN2,  EFHBIN2,  ZANTSl,  ZANTS2,  ZANTS3, 
ZANTS4,  ZANTS5 

EFHBIN2  =  EFFHB2  input  file  (output). 

ZANTSl  ~  Annual  habitat  time  series  file  for  adults 
(input). 

ZANTS2  “  Annual  habitat  time  series  file  for 
spawning  (input). 

ZANTS3  =  Annual  habitat  time  series  file  for  fry 
(input). 

If  5  input  files  are  being  used: 

ZANTS4  =  Annual  habitat  time  series  file  for  second 
fry  age  class  (input). 

ZANTS5  *  Annual  habitat  time  series  file  for  juve¬ 
niles  (input). 


SAMPLE  INPUT  FILE  TO  THE  EFFHAB2  PROGRAM  CREATED  BY  THE  EFFIN2  PROGRAM 
EFFECTIVE  HABITAT  FOR  GUNNISON  RIVER  BROWN  TROUT  -  ONE* YEAR  JUVENILE 
.25  10.00  8.00  4.00  2.00  0.00  0.00 

2 

SWIMUP 

FINGERLING 

1 

JUVENILE 

E  GUNNISON  1964  13049.0  4063.0  32.3  528.0  12715.0 

E  GUNNISON  1965  12719.0  2521.0  4.8  173.0  13551.0 


Fig.  9.13.  Sample  input  file  to  the  EFFHB2  program  created  by  EFFIN2. 
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If  4  input  files  are  being  used: 

ZANTS4  *  Annual  habitat  time  series  file  for  juve¬ 
niles  (input). 

Input  files  must  contain  the  same  number  of  years  of 
data  and  cannot  be  multirecord  files. 


ENtSR  <?  TO  JwmUAL  tlHE  ni£&  fOR  niJOT 

I  TO  mTEH  ALL  DAT^  FROM  ItEYgOftRO _ 


Remember,  if  annual  times  series  files  (ZANTS)  are 
being  used  as  input,  they  must  contain  the  same  number  of 
years  and  have  been  entered  in  the  order  described  (in 
running  EFFIN2  section)  when  running  EFFIN2. 


Enter  2-line  title  for  the  output  file  using  a  maximum  of 
80  characters  per  line. 

THE  FRY  LIFE  STAGE  HAY  BE  DIVIDED  INTO  2  AGE  CLASSES 
EXISTING  IN  THE  $AHB  YEAR.  EACH  HOST  HAVE  ITS  OWN 
AVAILABLE  HABITAT  TIME  SERIES.  HOW  MANY  FRY  AGE  CLASSES 
WILL  BE  DSED  (1  OR  2)? _ ' 


If  1  is  entered,  the  fry  life  stage  will  be  named  FRY. 
If  2  is  entered,  the  following  prompts  will  appear: 


ENTER  THE  NAME  OF  THE  YODMQER  AGE  CLASS  {10  CHARS  MAX)  i 


Enter  a  name  (10  characters  or  less)  for  the  younger  fry 
age  class. 

ENTER  THE  NAME  OF  THE  OLDER  FRY  AGE  CLASS  {IQ  CHARS  HAX^  ;  , 

Enter  a  name  (10  characters  or  less)  for  the  older  fry  age 
class. 

fRcm  1  TO  jVi^ENlLE CONSipEK^i|pi|p;i:||^^^^^^ 
EACH  EXISTING  ALL  YEAR  (  JtJVENILEl  *  1  YEAR  OLDS,  ’ 

:  auvEiiiiiLE2  :*  »  ' iji'-yEAR.'  OL!^y;| 

ONLY  1  xJUVENlLE  AVAILABLE  HABITAT  TIME  SERIES  CAN  BE 
PROVIDED,  AND  THAT  HABITAT  WILL  BE  SPLIT  AMONG  THE 
life  STAGES  AS  THE  OSBR  DESIGNATES.  HOW  MANY  JUVENILE 
liiFE  STAGES  WILL  bE  -  US^  ?'  '  '  ■  V;.- 


If  1  is  entered,  the  single  juvenile  life  stage  will  be  named 
JUVENILE. 

If  2  is  entered,  the  following  prompts  will  appear: 

ENTER  NAME  OF  THE  YOUNGEST  JOVENILE  LIFE  STAGE  {IQ  CHARS  MAX)'i 

Biter  name  (10  characters  or  less)  for  the  youngest 
juvenile  life  stage. 

ENTER  NAME  OF  THE  SECOND'  ^  LljPE (10  CHARS  MAX)  ;  '  vii:!; 


Enter  name  (10  characters  or  less)  for  the  older  life  stage. 


The  responses  to  the  following  two  prompts  must  add 
up  to  100.0. 

THE  available  GDVt»lLE  HABITAT  nmt  BE  BIVIBEO  BETWEEN  THE  Z 

JOVENILE  LIFE  STAGES.  ENTER  THE  mCENT  OF  JUVENILE  HABITAT 

THAT  SHOULD  BE  ALLOTTED  TO  THE  OLDER  JUVENILE  LIFE  STAGE 

-  U—}  .  TO  ALLOT  nm  OLDER  ALL  THEY  WANT  AND  THE  YOUNGER  WHAT 

The  blank  will  contain  the  name  entered  above.  Enter 
the  percentage,  from  0.0  to  100.0. 

enter  the  RERCENT  id  be  AIXOTTED  to  THE  YOUNGER  JUVENILE  LIFE 

STAGE-{ _ J .  TO  ALLOT  THEM  WHAT  IS  LEFT  OVER  FROM  THE  OLDER 

LIFE  stage,  enter  O.O. 

The  blank  will  contain  the  name  entered  here.  Enter  the 
percentage,  from  0.0  to  100.0.  Remember,  the  sum  of  the 
responses  to  these  two  prompts  must  equal  100.0. 

If  3  was  entered  for  the  number  of  juvenile  life  stages, 
the  following  prompts  will  appear: 

iiKR  NAME  OP  THE  YOUNGEST  JUVENILE  LIFE  STAGE  (10  CHARS  MAX^  t 

Enter  a  name  (10  characters  or  less)  for  the  youngest 
juvenile  life  stage. 

ENTER  NAME  OF  THE  SECOND  JUVENILE  LIFE  STAGE  (10  CHARS  MAX)  : 

Enter  a  name  (10  characters  or  less)  for  the  middle  life 
stage. 

i  FOTER  NAME  OF  ;THE  OLDEST  JUVENILE  LIFE  STAGE  (10  CHARS  MAX)  J 

Enter  a  name  (10  characters  or  less)  for  the  oldest  life 
stage. 

In  addition  to  these  prompts,  the  following  prompts 
will  also  be  asked  if  was  entered  to  indicate  that 

there  are  three  juvenile  life  stages. 

The  responses  to  the  following  three  prompts  must  add 
up  to  100.0. 

THE  available  JUVENILE  HABITAT  MUST  BE  DIVIDED  AmC»)G  ThE  S 

JUVENILE.  LIFE  STAGES.  FOR  THE  SPECIAL  CASE  IN  WHICH  THE  OLDEST 

TAKE  ALL  THEY  NEED,  THE  MIDDLE  TAKE  WHAT  THEY  NEED  FROM  WHAT 

IS  LEFT,  AND  THE  YOUNGEST  GET  WHAT  IS  LEFT  OVER  FROM  THE  2 

PLDER  STAGES,  ENTER  100.0  FCHl  THE  OLDEST  LIFE  STAGE  AND 

0.0  FOR  THE  MIDDLE  AND  YOtlHOEST  LIFE  STAGES.  ENTER  THE 

iiPERCENT  OF  JUVENILE  HABITAT  THAT  SHOULD  BE  ALLOTTED  TO  THE 

OIDEST  JUVENILE  LIFE  STAGE' I-K 

The  blank  will  contain  the  name  entered  previously. 
Enter  the  percentage,  from  0.0  to  100.0. 
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THE  PERCENTAGE  TO  EE  ALUWTED  TO  THE  MTOOEE 
JUVENILE  LIPE  STAGE-  > 

The  blank  wUl  contain  the  name  entered  previously. 
Enter  the  percentage,  from  0.0  to  100.0. 

ENTER  THE  PERCENTAGE  TO  EE  ALLOTTED  TO  THE  VOUNOEET 

JUVENILE  LIFE  STAGE:  (—1  .  _ 

The  blank  will  contain  the  name  entered  previously. 
Enter  the  percentage,  from  0.0  to  100.0.  Remember,  the 
sum  of  the  responses  to  these  three  prompts  must  equal 
100.0. 

-ENTER  THE  ADULT  SURVIVAL  FACTOR; _ 

The  adult  survival  factor  must  be  between  0.0  and  1.0. 

ENTER  THE  ADULT  EQUIVALENT  HABITAT  MULTIPLIER  FOR  SPAWNING; 

If  only  one  fry  age  class  is  being  used, 

ENTER  THE  ADULT  EQUIVALENT  HABITAT  MULTIPLIER  FOR  FRY; _ 

If  two  fry  age  classes  are  being  used, 

•enter  .THE  ADt^T  EqUXVALBNT  MULTIRLTERS  ROR  :thB  2  . 

ERV  AGE  CLASSES  ~ YOUNGEST  FIRST: 


The  following  prompts  will  be  repeated  for  each  input 
ZANTS  file.  The  blank  will  show  the  2  title  lines  from  the 
input  file  being  considered. 

X  FOR  MINIMUM 

OR  2  rOR  MAXIMUM  AS  RELEVANT  TIME  SERIES  _ 

This  prompt  refers  to  the  three  columns  of  numbers  on 
the  annual  time  series  file.  The  first  column  is  the  compos¬ 
ite  aimual  habitat  value  (average  of  the  maximum  and 
minimum  values  for  the  relevant  months).  The  second  and 
third  values  are  the  minimum  and  maximum  annual  habitat 
values,  respectively.  You  must  choose  the  index  appropri¬ 
ate  for  the  species-life  stage. 

For  example,  a  maximum  value  is  used  for  spawning, 
under  the  assumption  that  the  spawn  will  occur  at  any  time 
within  a  certain  (temperature^ow)  window.  In  contrast, 
a  minimum  value  may  be  more  appropriate  for  fry,  which 
are  more  vulnerable  to  catastrophic  events.  For  more  resil¬ 
ient  adults,  an  average  (composite)  may  be  the  most  ap¬ 
propriate.  In  any  case,  you  must  choose  a  biologically 
reasonable  response. 

ENTER  1  TO  ADO  A  VEaR  TO  THE  DATA 

Z  TO  SUBTRACT  A  YEAR  FROM  THE  DATA 
0  TO  LEAVE  THE  YEARS  UNCHANGED 


Separate  the  two  responses  with  a  space,  comma,  or  a 
carriage  return. 

If  o/ie  juvenile  life  stage  is  being  used, 

ENTER  THE  ADULT  EgUtVALENT  HABITAT  MULTIRLIER  FOR  JUVENILES; 

If  two  juvenile  life  stages  are  being  used, 

ENTER  THE  2  ADULT  EQUIVALENT  HABITAT  MULTIPLIERS  FOR  THE  2 
JUVENILE  LIFE  STAGES  -YOUNGEST  FIRST t _ ■ 

Separate  the  two  responses  with  a  space,  comma,  or  a 
carriage  return. 

If  three  juvenile  life  stages  are  being  used, 

ENTER  the'  i ,, adult  EQUIVALENT  l^ITAT  MULTIPLIERS  FOR  JUVENILES 
YOUNGEST.'.  MIDDLE^  THEN  oij>ESTt _ '  .  ^ 

Separate  the  three  responses  with  a  space,  comma,  or  a 
carriage  return. 


ENTER  STATION  INDEX  WS  CHAR)  ; 


Enter  the  station  ID,  using  a  maximum  of  8  characters. 

If  annual  time  series  files  were  used  as  input,  the  fol¬ 
lowing  prompts  will  appear  in  addition  to  those  ex¬ 
plained  above: 


This  prompt  allows  you  to  ensure  that  the  annual  index 
applies  to  the  correct  biological  year,  where  biological 
year  is  defined  as  beginning  with  the  month  of  the  hatch 
or  swimup.  You  are  responsible  for  defining  how  you  wish 
to  numerically  refer  to  a  biological  year  and  making  sure 
that  annual  index  values  are  synchronized  to  each  biologi¬ 
cal  year  for  each  interdependent  life  stage.  (This  is  a 
challenge — an  example  follows.) 

Most  monthly  habitat  time  series  analyses  are  performed 
in  a  water  year  format— that  is,  month  1  is  October,  month 
2  is  November,  and  so  forth.  October  of  water  year  1960 
is  really  in  calendar  year  1959.  To  further  complicate 
matters,  the  ANNTS  program  may  have  changed  the  year 
designation  based  on  its  algorithm  of  choosing  the  year 
from  the  greatest  number  of  months  considered  in  the 
annual  index  calculation. 

Hatch  of  a  theoretical  fall-spawning  species  is  in  March 
and  April.  We  further  assume  that  the  fry  life  stage  may  be 
from  March  through  November,  juvenile  from  December 
through  Februaiy,  and  adults  are  present  all  year.  The 
biological  year,  by  definition,  will  be  from  March  to 
February.  In  this  case,  the  fry  habitat  value  from  (calendar 
year  [and  water  year])  1960  matches  the  habitat  value  that 
should  be  used  to  characterize  biological  year  1960.  How¬ 
ever,  the  juvenile  habitat  value  from  (calendar  year  [and 
water  year])  1960  really  applies  to  biological  year  1959. 
This  is  because  the  December  through  February  habitat 
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value  following  the  hatch  is  in  the  next  water  year.  (In 
addition,  ANNTS  would  have  put  the  habitat  values  into 
1960  because  the  majority  of  months,  January  and  Febru¬ 
ary,  occur  in  calendar  year  1960.)  Thus,  you  would  need 
to  subtract  one  year  from  the  annual  designation  for  juve¬ 
niles.  Adults,  present  year  round  in  our  example,  will  not 
need  to  be  changed.  Figure  9. 12  diagrams  this  concept. 

All  this  can  be  ccmfusing.  We  recommend  that  the  output 
from  both  ANNTS  and  EFFIN2  be  scrutinized  to  ensure 
that  the  biological  year  is  properly  characterized  and  all 
life  stages  are  synchronized  before  running  the  EFFHB2 
program.  You  may  need  to  delete  mismatched  biological 
years  from  certain  life  stages  when  you  have  finished, 
using  a  text  editor.  Totally  illogical  results  ate  assured  if 
care  is  not  taken. 


COHK>gXT1S  ntB  WTTH  t-lt  YgARS  WRmEH. _ 

The  blank  will  be  filled  with  the  number  of  years  of  data 
written  to  the  output  file.  The  output  file  should  now 


contain  the  data  in  a  format  that  can  be  read  by  the 
EFFHB2  program. 

If  all  data  is  being  entered  from  the  keyboard,  the 
following  prompts  will  appear  in  addition  to  those 
explained  above: 

nti&r  year  or  oata; _ 


Enter  the  year  number  for  the  first  year  of  data. 


WnWAL  HABITAT  DATA:  . 

Values  tot  ^aCh.  iA  this  fQXSiUt; 

Bspaists  saeh  VAlus  vith  A  spacu  and  follov  tbs  last  valus 
with  a  camiags  returb.  when  all  years  of  data  hava  been  an 
taxed,  type  Q  to  quit. 

Vflar  Adult  ^pAwninff  SMisUip  FiAB6l3inff  JpVAAilg. 


[xxxx]  is  the  first  year  number  entered  in  the  prompt 
Enter  first  year  of  data 
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Introduction 

The  LPTDAN  program  reads  one  or  two  annual  time 
series  files  and  writes  an  output  file  containing  an  annual 
duration  table  showing  ordered  annual  data,  a  summaiy 
statistics  table  containing  average,  median,  index-A  (aver¬ 
age  of  the  interval  between  50  and  90%  duration),  in^x-B 
(average  of  the  interval  between  10  and  90%  duration), 
index-C  (a  user-defined  index),  10%,  20%,  80%,  and  90% 
exceedence,  and  an  exceedence  plot. 

When  two  annual  time  series  files  are  used  as  input,  they 
do  not  have  to  contain  the  same  number  of  years  of  data. 

Running  LPTDAN 

RLPTDAN,  ZOUT,  ZANTS,  ZANTS2 

ZOUT  =  LPTDAN  results  (output). 

ZANTS  =  Annual  time  series  file  (input). 

ZANTS2  =  Second  annual  time  series  file  (input). 


Input  files  do  not  have  to  contain  the  same  number  of 
years.  Multirecord  files  may  be  used. 


If  ZANTS  files  are  from  the  ANNTS  or  ANEQTS 
program: 

ENTER  0  TO  CHOOSE  CCfMPOSlTE^  MINIMUM,  AND  MAXIMUM 
VALUES  FOR  EACH  RECORD 

1  TO  CHOOSE  COMPOSITE,  MINIMUM,  AND  MAXIMUM  VP  - ' 

_ VALUES  ONCE  FOR  ALL  RECORDS _ ji^.:  _ 

This  prompt  refers  to  the  three  columns  of  numbers  on  the 
annual  time  series  file  fiom  the  ANNTS  or  ANEQTS  pm- 
grams.  The  first  column  is  the  composite  armual  habitat 
value  (average  of  the  maximum  and  minimum  values  for  the 
relevant  months).  The  second  and  third  values  are  the  mini¬ 
mum  and  maximum  armual  habitat  values,  respectively.  You 
must  choose  the  index  appropriate  for  the  species4ife  stage. 

For  example,  a  maximum  value  is  us^  for  spawning, 
under  the  assumption  that  the  spawn  will  occur  at  any  time 
within  a  certain  (temperature-flow)  window.  In  contrast,  a 
minimum  value  may  be  more  appropriate  for  fry,  which  ate 
more  vulnerable  to  catastrophic  events.  For  more  resilient 
adults,  an  average  may  be  the  most  appropriate.  In  any  case, 
you  must  choose  a  biologically  reasonable  response. 

If  0  is  entered,  the  following  prompt  will  appear  for 
each  record  (usually  life  stages)  in  the  data  set. 


If  1  is  entered,  the  following  prompt  will  appear  once  and 
the  same  value  (composite,  minimum,  or  maximum)  will  be 
used  for  each  record  in  the  data  set. 


EJnER  0  TO  USE  COMPOSITE  VALUES 

1  TO  USE  minimum  values,  m 

2  TO  USE  MAXIMUM  VALUES  FOR  ALL  CALCULATIONS 

If  ZANTS  files  are  from  the  EFFHAB  or  EFFHB2 
programs: 


ENTER  0  TO  CHOOSE  AVAILABLE  OR  EFFECTIVE  HABITAT  VALUES 
FOR  EACH  RECORD 

1  TO  CHOOSE  AVAILABLE  OR  EFFECTIVE  HABITAT  VALUES 
_ ONCE  FOR  all  records 


This  prompt  refers  to  the  two  columns  of  numbers  on  the 
annual  time  series  file  from  the  EFFHAB  and  EFFHB2 
programs.  The  first  column  is  the  available  annual  habitat 
value  and  the  second  is  the  effective  annual  habitat  value. 
You  must  choose  the  value  you  wish  to  plot. 

If  0  is  entered,  the  following  prompt  will  appear  for  each 
record  (usually  life  stages)  in  the  data  set. 

If  1  is  entered,  the  following  prompt  will  appear  once 
and  the  same  value  (available  or  effective)  will  be  used 
for  each  record  in  the  data  set. 


ENTER  0  TO  USE  AVAILABLE  HABITAT  VALUES,  OR 

1  TO  USE  EFFECTIVE  HABITAT  VALUES  FOR  ALL  CALCULATIONS. 

ENTER  TABLE  LABEL  FOR  FIRST  SET  <UP  TO  14  CHAR) r  • 

Die  program  will  display  the  first  two  lines  of  the  fust  data 
set  for  user  identification.  Die  label  should  identify  the  data 
set  and  will  appear  on  the  output  tables.  If  two  data  sets  were 
qiecified  as  input,  the  same  prompt  will  appear  for  the 
second  data  set. 


LJTTJMI  WItL  CCWPOTE  XNDEX-A  I50'90SU  AMD  IMDEX-B  (10-90%) 

EMTER  1  TO  DEFIME  AM  INDEX  C,  0  OTHERWISE. 

In(iex-C  may  be  useful  if  the  exceedence  values  described 
by  index-A  and  index-B  are  irrelevant  to  your  application  or 
do  not  cover  the  percentages  of  interest.  For  example,  if  the 
events  in  the  90-100%  exceedence  category  are  thought  to 
be  impottant  population  limiting  events,  then  you  may  wish 
to  define  index-C  as  covering  the  90-100%  exceedence 
categoiy. 

Ifl  is  entered  to  define  an  index-C: 


rarrER  THE  LOWER  AND  UPPER  BOUNDARIES  FOR  INDEX -C? 
ENTER  1  TO  WRITE  DURATION  TABLE <S},  0  OTHERWISE . 
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These  are  tables  diowing  ordered  annual  data. 

ENTER  1  FOR  PURATIOM  >UQT(S) ,  0  OTHERWISE 

These  are  annual  exceedence  plots. 

If  tables  or  plots  are  to  be  written: 

ENTER  RUST  &  miRATIOH  T&BUS  TITLE  LINE  (UP  TO  70  CHAR)  t 

This  title  will  appear  below  the  X-axis  on  plots  and 
above  each  duration  table. 

enter  X  K)R  tOO^tmAR  0  ROR  U»EAR-i.XNEj^R> _ 


The  Y-axis  will  represent  the  data  values.  Enter  “1  ”  for 
the  X-axis  on  a  log  scale,  or  “0”  for  the  X-axis  on  a 
linear  scale. 

The  following  prompt  will  appear  if  the  linear-4inear 
plotting  option  is  chosen.  For  log-linear,  the  X-axis  will 
automatically  begin  at  the  minimum  X  data  value. 


ENTER  0  F£»  X-AXIS  TO  BEGIN  AT  0, 

ENTER  i  to  BEGIN  XT  MINIMOM  X*DXTA  VAtVB. 
®rrER  X‘AXI3  LABEL  (OR  TO  10  CHARACTERS) 


This  X-axis  label  will  appear  on  the  exceedence  plot. 
The  label  should  describe  the  type  of  input  data,  and 
possibly  the  units. 

Figure  9. 14  contains  sample  output  from  the  LPTDAN 
program. 


PROGEIAM  -  LPTDAN 
PAGE  -  1 

FIRST  DATA  SET  IS  - 

SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


ANNUAL  TIME  SERIES  -  COMPOSITE  VALUES 


YEAR 

VALUE 

YEAR 

VALUE 

YEAR 

VALUE 

YEAR 

VALUE 

1971 

14211.30 

1972 

14561.70 

1973 

16685.00 

1974 

14378.30 

1975 

14737  .70 

1976 

16016.40 

1977 

17336 .20 

197  8 

17334 .10 

1979 

16752.80 

1980 

17028.30 

1981 

15907 . 10 

ANNUAL  1 

HABITAT  TIME 

SERIES 

ANALYSIS  - 

1971-82 

ORDERED  ANNUAL  DATA  -  COMPOSITE  VALUES 


ORDER 

PRE- 

■  PROJECT 

PLOTTING 

NUMBER 

YEAR 

ELEMENT 

POINT 

1 

1977 

17336.20 

4.55 

2 

197  8 

17334.10 

13.64 

3 

1980 

17028.30 

22.73 

4 

1979 

16752.80 

31.82 

5 

1973 

16685.00 

40.91 

6 

1976 

16016.40 

50.00 

7 

1981 

15907 . 10 

59.09 

8 

1975 

14737.70 

68.18 

9 

1972 

14561.70 

77.27 

10 

1974 

14378.30 

86.36 

11 

1971 

14211.30 

95.45 

DATE  -  90/06/06. 
TIME  -  15.28.42. 


Fig.  9.14.  Sample  output  from  the  LPTDAN  program.  Only  the  output  fc«*  rainbow  trout — fiy  has  hem  included  in  this  sair^)le  output. 
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DATE  -  90/06/06.  SNOQUALMIE  RIVER  PROGRAM  -  LPTDAN 

TIME  -  15.28.42.  FRY  RAINBOW  TROUT  PAGE  -  3 

SUMMARY  STATISTICS  FOR  1971  THRU  1981  -  COMPOSITE  VALUES 


PRE- PROJECT 

AVERAGE 

15904.445 

0.000 

MEDIAN 

= 

16016.400 

0.000 

INDEX -A 

15032.231 

0.000 

INDEX -B 

= 

15933.748 

0.000 

INDEX- C 

14947.046 

0.000  *** 

10 

PERCENT 

17334.939 

0.000 

20 

PERCENT 

= 

17120.041 

0.000 

80 

PERCENT 

- 

14506.680 

0.000 

90 

PERCENT 

14311.500 

0.000 

***  INDEX -C  IS  THE  AVERAGE  PERCENTAGE  EXCEEDENCE 
BETWEEN:  50.00  AND  95.00 


DATE  -  90/06/06. 
TIME  -  15.28.42. 

100.00  ======== 

# 

# 

# 

# 

90.000  # - 

# 

# 

# 

80.000  # - 

# 

# 

# 

# 

70.000  # - 

# 

# 

# 

# 

60.000  # - 

# 

# 

%  EXCEEDED  # 

# 

50.000  # - 

# 

# 

# 

# 

40.000  # - 

# 

# 

# 

# 

30.000  # - 

# 

# 

# 

# 

20.000  # - 

# 

# 

# 

# 

10.000  # - 

# 

# 

# 

# 

O.OOOOOE-01  ===-===: 
l.OOOOE+04 

Fig.  9.14.  Continued 


SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


PROGRAM  -  LPTDAN 
PAGE  -  4 


HABITAT  l.OOOOE+05 

ANNUAL  HABITAT  TIME  SERIES  ANALYSIS  -  1971-82 
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Appendix  A.  Sample  File  Formats 


Name 


Multirecord  File  Format . 197 

Daily  Streamflow  File  in  WATSTORE  Format  (ZDQ) . 197 

Monthly  Streamflow  File  in  NWDC  Format  (ZMONQ) . 198 

Monthly  Streamflow  File  in  USGS  Format  (ZMONQ) . 198 

Habitat  Area-versus-Streamflow  File  (ZHAQF)  . 198 

Monthly  Habitat  Time  Series  File  (ZMTS) . 199 

Annual  Habitat  Time  Series  File  (ZANTS) . 200 

HABNET  Input  File  (ZHABIN)  . 201 

File  Format  for  a  ZHABIN  File  . 202 

Modified  Monthly  Time  Series  (ZMTSM)  File  (Input  to  HABNET)  . 203 

File  Format  for  a  ZMTSM  File . 204 

Modified  Habitat  Area-versus-Flow  (ZHAQFM)  File  (Input  to  HABNET) . 205 

File  Format  for  a  ZHAQFM  File . 206 

Temperature  Time  Series  (ZTEMP)  File  (Input  to  HABNET) . 206 

File  Format  for  a  Free-formatted  ZTEMP  File . 207 

Temperature  Suitability  Index  (ZTSI)  File  (Input  to  HABNET) . 208 

File  Format  for  a  Free-formatted  ZTSI  File  . 208 

Miscellaneous  Sample  Data  Files . 209 


Sample  Data  Sets 


197 


A  miiltirecord  file  has  the  following  format  requirements: 


1.  The  record  names  must  be  1-  to  7-character  names,  constructed  from  the  characters  a-z,  A-Z,  and  0-9.  Other 
characters  may  be  legal  for  MS-DOS  applications  but  will  not  be  legal  for  CDC  implementations.The  record  nanift 
will  be  the  first  7  characters  on  the  first  line. 


2.  Hie  end-of-recotd  marks  may  be  either  #EOR  or  #eor  and  must  be  the  first  4  characters  on  a  line.  This  special 
end-of-record  mark  is  required  so  that  transfer  of  this  data  file  using  the  CDC  CONNECT  software  from 
microcomputers  to  CDC  mainframes  will  work  properly.  Conversely,  a  standard  CDC  multirecord  data  file  will 
contain  these  same  characters  if  transferred  from  the  mainframe  to  nucro  using  CONNECT.  CONNECT  is  a 
copyrighted  program  available  for  free  distribution  to  CDC  users. 


3.  The  data  comprising  the  text  data  must  be  standard  ASCII  lines  <  32,767  characters  in  length,  terminated  by  a 
carriage  return-line  feed  sequence.  (To  conform  to  CDC  standards,  however,  we  recommend  that  a  line  be  no  longer 
than  136  characters.)  Any  ASCII  editor  will  create  such  a  file. 


Daily  Streamflow  File  in  WATSTORE  Format 

ZDQ  =  default  filename 
DQ  DAT  =  sample  file  on  disk 

H  12142000  4736541214244005353033SW17110010  64.00  1130.00 

N  12142000  N.F.  SNOQUALMIE  RIVER  NR  SNOQUALMIE  FALLS,  WA. 

12142000  0006000003  ENT 

3  12142000  19701001  138.00  129.00  120.00  116.00  431.00  324.00  230.00  205.00 

3  12142000  197010021370.00  766.00  456.00  496.00  362.00  288.00  248.00  218!oO 

3  12142000  19701003  198.00  205.00  312.00  362.00  468.00  468.00  710.00  740.00 

3  12142000  19701004  444.00  330.00  273.00  245.00  222.00  209.00  196.00 

3  12142000  19701101  187.00  183.00  172.00  158.00  152.00  183.00  172!oO  270.00 

3  12142000  19701102  448.00  297.00  365.001260.00  700.00  424.00  386.001020.00 

3  12142000  19701103  620.00  715.00  720.00  665.00  456.00  34 8 . 0013 10 . 003 090 ! 00 

3  12142000  197011041140.00  665.00  508.00  400.00  340.00  312.00 

3  12142000  19701201  282.00  260.00  240.00  225.00  592.002550.002330.00  975.00 

3  12142000  19701202  606.00  588.00  700.00  476.00  393.00  348.00  351.00  350.00 

3  12142000  19701203  310.00  266.00  250.00  230.00  210.00  200.00  190.00  177.00 

3  12142000  19701204  165.00  165.00  165.00  180.00  260.00  400.00  450.00 

3  12142000  19710101  260.00  220.00  196.00  178.00  169.00  158.00  172!oO  500  00 

3  12142000  197101021270.00  960.00  600.00  382.00  315.00  273.00  394.00  814.00 

3  12142000  197101031030.001070.004050.001380.00  796.00  675.001310.001380.00 

3  12142000  197101041020.002380.001550.00  916.00  680.001580.002390.00 

3  12142000  197102011380.00  947.00  705.00  588.00  480.00  412.00  372.00  340.00 

3  12142000  19710202  358 . 00197 0 . 001740 . 001310 . 002270 . 00177 0 . 001930 . 001080 ! 00 

3  12142000  19710203  740.00  640.00  530.00  460.00  440.00  420.00  405.00  580.00 

3  12142000  19710204  460.00  380.00  340.00  308.00 

3  12142000  19710301  282.00  280.00  270.00  250.00  235.00  220.00  320.00  300.00 

3  12142000  19710302  270.00  380.00  560.00  500.00  410.00  355.00  310.00  285.00 

3  12142000  19710303  265.00  240.00  234.00  227.00  215.00  225.00  450.00  76o!oO 

3  12142000  19710304  500.00  450.00  410.00  380.00  920.001100.00  690.00 

3  12142000  19710401  500.00  436.00  379.00  368.00  448.00  620.00  565.00  529.00 

3  12142000  19710402  610.00  601.00  480.00  400.00  372.00  412.00  448.00  382!oo 

3  12142000  19710403  330.00  306.00  288.00  324.00  327.00  300.00  300.00  309^00 

3  12142000  19710404  306.00  534.00  725.00  645.00  560.00  524.00 

3  12142000  19710501  730.001230.001500.001310.00  968.00  778.001030.001300.00 

3  12142000  197105021010.00  947.001260.001670.001580.001030.00  740.00  880.00 

3  12142000  19710503  725.00  601.00  954.00  975.00  730.00  820 . 001000 . 001130 ! 00 

3  12142000  197105041230.001200.001280.001280.001210.00  904.00  665.00 

3  12142000  19710601  601.00  625.00  665.00  685.00  635.00  750.001060.00  975.00 

3  12142000  19710602  745.00  808.00  947.00  820.00  910.001410.00  996.00  772.00 

3  12142000  19710603  675.00  772.001140.001030.001120.001420.001240.00  868.00 

3  12142000  197106041270.00  868.00  685.00  630.00  556.00  583.00 

3  12142000  19710701  610.00  542.00  588.00  625.00  601.00  710.00  592.00  552.00 

3  12142000  19710702  820.001110.00  910.00  750.00  745.00  838.00  947.00  922.00 

3  12142000  19710703  838.00  968.001020.00  940.00  838.00  725.00  650.00  583!oO 

3  12142000  19710704  583.00  606.00  556.00  529.00  542.00  516.00  476.00 

3  12142000  19710801  428.00  340.00  297.00  276.00  270.00  260.00  250.00  245.00 

3  12142000  19710802  225.00  207.00  194.00  183.00  168.00  156.00  144.00  132.00 

3  12142000  19710803  123.00  116.00  113.00  113.00  116.00  170.00  148.00  120  00 

3  12142000  19710804  108.00  102.00  96.00  92.00  89.00  89.00  112.00 

3  12142000  19710901  152.00  677.00  488.00  258.00  238.00  372.00  230.00  185.00 

3  12142000  19710902  183.00  160.00  230.00  200.00  160.00  138.00  123.00  113!o0 

3  12142000  19710903  105.00  98.00  94.00  89.00  86.00  82.00  80.00  87.00 

3  12142000  19710904  185.00  136.00  148.00  432.00  452.00  270.00 
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Monthly  Streamflow  File  in  NWDC  Format 


ZMONQ  =  default  fllename 
NWDC.DAT  =  sample  file  on  disk 


NORTH  PORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH 
MEAN  MONTHLY  DISCHARGE  *  1962  THRU  1977 


12142000 

1962 

1 

523 

479 

715 

865 

363 

243 

12142000 

1962 

2 

709 

510 

568 

318 

281 

197 

12142000 

1963 

1 

300 

721 

748 

421 

686 

314 

12142000 

1963 

2 

523 

456 

394 

247 

125 

149 

12142000 

1964 

1 

315 

751 

549 

668 

380 

412 

12142000 

1964 

2 

533 

846 

1219 

692 

439 

405 

12142000 

1965 

1 

365 

568 

742 

920 

771 

329 

12142000 

1965 

2 

637 

587 

461 

222 

146 

243 

12142000 

1966 

1 

352 

475 

429 

543 

275 

472 

12142000 

1966 

2 

666 

798 

599 

424 

120 

78 

Monthly  Streamflow  FUe  in  USGS  Format 

ZMONQ  =  defaxilt  filename 
USGS.DAT  *  sample  file  on  disk 


NORTH  FORK  SNOQUALMIE  RIVER  NEAR  SNOQUALMIE  FALLS  WASH 
MEAN  MONTHLY  DISCHARGE 


121420001962 

121420001962 

121420001963 

121420001963 

121420001964 

121420001964 

121420001965 

121420001965 

121420001966 

121420001966 


1962 
523. 
709  . 
300. 
523. 
315. 
533  . 
365. 
637  . 
352. 
666  . 


THRU 
00  479 
00  510 
00  721 
00  456 
00  751 
00  846 
00  568 


587 

475 


1977 
.00  715.00 
.00  568.00 
.00  748.00 
.00  394.00 
.00  549.00 
.00  1219 

.00  742.00 
.00  461.00 
.00  429.00 
.00  599.00 


865. 
318. 
421 . 
247  . 
668  . 
692, 
920. 
222. 
543  , 
424  . 


00  363.00 
00  281.00 
00  686.00 
00  125.00 
00  380.00 
00  439.00 
00  771.00 
00  146.00 
00  275.00 
00  120.00 


243.00 
197 .00 
314.00 
149.00 
412.00 
405.00 
329 .00 
243.00 
472.00 
78.00 


Habitat  Area-versus-Streamflow  File 

ZHAQF  =  default  filename 
HAQF.DAT  =  sample  file  on  disk 

SNOQUALMIE  RIVER 

NEAR  SNOQUALMIE  FALLS,  WA 

RAINBOW  TROUT 


DISCHARGE 

FRY 

JUVENILE 

ADULT 

10.00 

20570.00 

8220.00 

5780.00 

100.00 

15400.00 

4770.00 

3200.00 

150.00 

18880.00 

7230.00 

4890.00 

200.00 

19790.00 

9360.00 

6410.00 

250.00 

19780.00 

11470.00 

8020.00 

300.00 

19110.00 

13140.00 

9410.00 

350.00 

18050.00 

14110.00 

10400.00 

400.00 

16290.00 

15850.00 

12600.00 

500.00 

14470.00 

16360.00 

13660.00 

600.00 

11030.00 

14610.00 

13380.00 

800.00 

9090.00 

12310.00 

11740.00 

1000.00 

7410.00 

9270.00 

8880.00 

1500.00 

6940.00 

8490.00 

7620.00 

2000.00 

7210.00 

8630.00 

7810.00 

4000.00 

6660.00 

9480.00 

8510.00 

6000.00 

5740.00 

9890.00 

9670.00 

1214200000 


1214200000 
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Monthly  Habitat  Time  Series  File 

(Multiiecord  file  in  NWDC  format) 

ZMTS  “  default  filename 
MTS.DAT  -  sample  file  on  disk 


CLASSAl 


SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


12142000 

1971 

1 

16894 

14585 

16598 

12035 

12444 

16865 

12142000 

1971 

2 

15501 

8019 

9006 

10400 

17841 

17452 

12142000 

1972 

1 

16294 

12313 

15399 

15073 

11639 

9344 

12142000 

1972 

2 

12353 

8409 

8325 

12460 

18655 

15320 

12142000 

1973 

1 

17  872 

16138 

13202 

16229 

18966 

19033 

12142000 

197  3 

2 

17418 

14164 

14600 

17977 

17492 

17434 

#EOR 

CLASSA2 

SNOQUALMIE 

RIVER 

JUVENILE 

RAINBOW 

TROUT 

12142000 

1971 

1 

11761 

12041 

11761 

10643 

12995 

12959 

12142000 

1971 

2 

14707 

10262 

11720 

13246 

8165 

8814 

12142000 

1972 

1 

10550 

14077 

13141 

13486 

11449 

10875 

12142000 

1972 

2 

13863 

10354 

10751 

13459 

8464 

8327 

12142000 

1973 

1 

7892 

11082 

9920 

12329 

9651 

11976 

12142000 

1973 

2 

13516 

14539 

14240 

7768 

6166 

8132 

#EOR 

CLASSA3 

SNOQUALMIE 

RIVER 

ADULT 

RAINBOW 

TROUT 

12142000 

1971 

1 

9010 

9791 

9071 

9020 

10944 

10009 

12142000 

1971 

2 

11900 

9625 

10945 

12098 

5691 

6400 

12142000 

1972 

1 

8094 

12206 

10433 

10772 

9810 

9675 

12142000 

1972 

2 

11920 

9470 

10102 

11600 

5823 

6294 

12142000 

1973 

1 

5479 

8662 

8123 

9568 

6827 

8630 

12142000 

1973 

2 

10340 

12099 

11776 

5337 

4244 

5910 

#EOR 
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Annual  Habitat  Time  Series  File 

ZANTS  =  default  filename 
ANTS.DAT  -  sample  file  cm  disk 

(Multiiecord  File) 


CLASSAl 

SNOQUALMIE  RIVER 

FRY  RAINBOW  TROUT 


A  12142000 

1971 

14211.3 

9006.0 

17841.0 

A  12142000 

1972 

14561.7 

8325.0 

18655.0 

A  12142000 

1973 

16685.0 

14600.0 

17977.0 

A  12142000 

1974 

14378.3 

7804.0 

18474.0 

A  12142000 

1975 

14737  .7 

9786.0 

17229.0 

A  12142000 

1976 

16016.4 

12494.0 

18238.0 

A  12142000 

1977 

17336.2 

15855.0 

17876.0 

A  12142000 

1978 

17334.1 

16031.0 

18622.0 

A  12142000 

1979 

16752.8 

15320.0 

17188.0 

A  12142000 

1980 

17028.3 

15625.0 

18762.0 

A  12142000 

#EOR 

CLASSA2 

1981 

15907.1 

11700.0 

19105.0 

SNOQUALMIE 

RIVER 

JUVENILE 

RAINBOW 

TROUT 

A  12142000 

1971 

10502.0 

8165.0 

13246.0 

A  12142000 

1972 

9781.7 

7892.0 

13459 . 0 

A  12142000 

1973 

9421.4 

6166.0 

14240.0 

A  12142000 

1974 

9306.1 

6025.0 

13166.0 

A  12142000 

1975 

10600.1 

7595.0 

12469.0 

A  12142000 

1976 

10850.5 

7163.0 

13878 . 0 

A  12142000 

1977 

9571.4 

6922.0 

12536.0 

A  12142000 

197  8 

10327.8 

7193.0 

14229.0 

A  12142000 

1979 

9050.7 

5824.0 

14295.0 

A  12142000 

1980 

9793.3 

6585.0 

14608.0 

A  12142000 

#EOR 

CLASSA3 

1981 

9707.1 

5650.0 

13070.0 

SNOQUALMIE 

RIVER 

ADULT 

RAINBOW 

TROUT 

A  12142000 

1971 

8645.2 

5691.0 

12098.0 

A  12142000 

1972 

7855.2 

5479.0 

11600.0 

A  12142000 

197  3 

7133.3 

4244.0 

11776.0 

A  12142000 

1974 

7580.0 

4108 . 0 

12147 . 0 

A  12142000 

197  5 

8561.0 

5384.0 

11463.0 

A  12142000 

197  6 

8490.2 

5067.0 

11969.0 

A  12142000 

1977 

7094 . 0 

4701 . 0 

9908.0 

A  12142000 

197  8 

7690.3 

4899.0 

11148.0 

A  12142000 

1979 

6785.6 

3988.0 

11583 . 0 

A  12142000 

1980 

7271.8 

4472.0 

11736.0 

A  12142000 

1981 

7495.5 

3836.0 

11392.0 

#EOR 
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ZHABIN  FOe  Used  as  Input  to  the  HABNET  Program 
(Created  by  the  HABINN  Program) 

ZHABIN  *  default  filename 
HABIN.DAT  *  sample  file  on  disk 

POUDRE  RIVER  TOTAL  NETWORK  ANALYSIS 
TEMP  FORMAT  1 
ENGLISH  UNITS 
WY:KSQFT 

FIRST  YEAR  OF  DATA  1954 
LAST  YEAR  OF  DATA  1983 

111111111111 
8.0 
38.0 
6.3 
4.9 
5.1 
1.0 
6.3 

ADULT 
JUVENILE 
FRY 

SPAWNING 
ADULT 
JUVENILE 
FRY 

SPAWNING 


Sample  ZHABIN  file  used  as  input  to  HABNET 


MONTHS 
1  SEG  1.5 
1  SEG  1.4 
1  SEG  1.1 
1  SEG  2.2 
1  SEG  3.3 
1  SEG  4.1 
1  SEG  4.2 
********** 

1  BROWN 
1  BROWN 
1  BROWN 
1  BROWN 
1  RAINBOW 
1  RAINBOW 
1  RAINBOW 
1  RAINBOW 
********** 
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File  Format  for  a  ZHABIN  File 
(HABNET  Input  File) 

Line  1:  This  title  line  will  be  written  to  the  habitat  time 
series  file  (ZMTS)  and  output  file  (ZOUT)  from  HAB¬ 
NET 

Line  2:  Temperature  suitability  file  format  being  used  as 
input  (ZTSI  file): 

0  No  temperature  suitability  index  file, 

1  *  Network  temperature  suitability  index  file,and 

2  ®  FISHCRV  file  with  temperature  criteria. 

Line  3:  Units  flow  data  and  segment  lengths  are  in 
METRIC  UNITS  or 
ENGLISH  UNITS. 

Line  4:  This  Une  is  for  reference,  and  the  information  will 
appear  in  the  HABNET  output.  These  values  are  not 
used  in  the  HABNET  calculations. 


Line  7:  Twelve  time  period  flags — these  12  flags  refer  to 
the  months  of  gaging  station  data.  If  1,  that  month  will 
be  processed;  if  0,  that  month  will  be  skipped.  The 
months  are  in  the  order  specified  by  the  units  (calendar 
year  or  water  year). 


Columns  Format 
1-20 

21-32  A12 

33-80 


Description 

MONTHS  (program  does  not 
care  what  is  entered  in  these 
columns) 

Processing  indicator: 

1  =  process  this  month, 

0  *  do  not  process  this  month. 
Blank — may  be  used  for 
comments. 


Lines  8-N:  Gaging  station/segment  information:  One  line 
of  information  for  each  gaging  station-segment. 


Columns: 

1-3  Time  codes  (with  a  trailing  :)  For  example, 
AY:  =  agricultural  year, 

CY:  *=  calendar  year, 

WY:  water  year,  and 
=*  blank. 

4-10  Measurement  units  codes 

(left-justified) — ^KSQFT  or  KSQM 
1 1-80  Blank^nnay  be  used  for  comments. 

Line  5:  The  first  year  of  data  to  be  processed  from  the 
gaging  station  flow  data  file  (ZMTSM). 


Columns  Format 

Description 

1-21 

FIRST  YEAR  OF  DATA  (program 

does  not  care  what  is  entered 

in  these  columns) 

22-25  14 

Year  number  for  first  year  of 

data  to  be  processed  from 

ZMTSM  file 

Columns 

Format 

Description 

1 

A1 

Processing  indicator: 

1  =  process  this  segment 

0  “  do  not  process  this  segment 

2 

Blank 

3-10 

8  Characters 

Segment  ID 

11-20 

Blank — may  be  used  for 
comments. 

21-27 

F10.2 

Segment  length 

28-80 

Blank — may  be  used  for 
comments. 

End-of-gaging  station/segment  indicator:  Enter  a  line  of 
10  asterisks  (**********)  in  columns  1-10  to  indicate 
end  of  gaging  station-segment  information. 

Specie^ife  stage  information:  One  line  of  information  for 
each  species-life  stage. 


26-80 


Blank — may  be  used  for 
comments 


Line  6:  The  last  year  of  gaging  data  to  process  from  the 
ZMTSM  file. 


Columns  Format 
1-21 

22-25  14 

26-80 


Description 

LAST  YEAR  OF  DATA 
(program  does  not  care  what  is 
entered  in  these  columns) 

Year  number  for  last  year  of 

data  to  be  processed  from 

ZMTSM  file 

Blank — may  be  used  for 

comments. 


Columns  Format  Description 

1  A1  Processing  indicator: 

1  =  process  this  species-life 
stage, 

0  *  do  not  process  this 
species-life  stage. 

2  Blank 

3-12  10  Characters  Species  name  (left-justified) 
13-22  10  Characters  Life  stage  name  (left-justified) 
23-80  Blank — may  be  used  for 

comments. 

End-of-specie^ife  stage  indicator:  Biter  a  line  of  10 
asterisks  (**********)  in  columns  1-10  to  indicate  end 
of  species-life  stage  information. 
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Modified  ZMTS  File  Used  as  Input  to  the  HABNET  Program 

(Modifications  Done  with  an  Editor) 


ZMTSM  =  default  filename 
MTSM.DAT  =  sample  file  on  disk 


Note:  The  ZTEMP  file  (temperature  time  series  data  in  USGS  or  NWDC  format)  is  in  the  same  format  as  the 
ZMTSM  file,  except  it  contains  temperature  data  instead  of  flow  data. 


NETWORK  GAGING  STATION  DATA  CACHE  LA  POUDRE  -  USGS  FORMAT 
MEAN  MONTHLY  FLOWS  (CFS) 

POUDRE  RIVER  SEGMENT  1  SITE  5  FLOWS  (NOTE:  SAME  FLOW  THRU  1) 


Q 

SEG 

1.5 

1954 

1 

20.00 

17.00 

16.00 

19.00 

13.00 

6.00 

Q 

SEG 

1.5 

1954 

2 

38.00 

492 

534 

228 

75.00 

101 

Q 

SEG 

1.5 

1955 

1 

55.00 

14.00 

7.00 

15.00 

8.00 

5.00 

Q 

SEG 

1.5 

1955 

2 

9.00 

451 

882 

401 

248 

65.00 

Q 

SEG 

1.5 

1956 

1 

32.00 

25.00 

32.00 

24.00 

19.00 

19.00 

Q 

SEG 

1.5 

1956 

2 

34.00 

1056 

1367 

342 

168 

95.00 

Q 

SEG 

1.5 

1957 

1 

26.00 

19.00 

17 .00 

17,00 

16.00 

13.00 

Q 

SEG 

1.5 

1957 

2 

21.00 

227 

1689 

1545 

445 

323 

Q 

SEG 

1.5 

1958 

1 

38.00 

25.00 

19.00 

16.00 

17 .00 

17.00 

Q 

SEG 

1.5 

1958 

2 

26.00 

733 

1317 

375 

219 

141 

Q 

SEG 

1.5 

1959 

1 

56.00 

18.00 

15.00 

14.00 

13.00 

14.00 

Q 

SEG 

1.5 

1959 

2 

22.00 

305 

1479 

528 

283 

176 

Q 

SEG 

1.5 

1960 

1 

47 .00 

35.00 

25.00 

19.00 

18 . 00 

21.00 

Q 

SEG 

1.5 

1960 

2 

91.00 

570 

1483 

552 

228 

161 

Q 

SEG 

1.5 

1961 

1 

31.00 

20.00 

18.00 

18.00 

15.00 

13.00 

Q 

SEG 

1.5 

1961 

2 

17 .00 

366 

1181 

443 

298 

238 

Q 

SEG 

1.5 

1962 

1 

116 

61.00 

57.00 

36.00 

30.00 

26.00 

Q 

SEG 

1.5 

1962 

2 

153 

821 

1125 

731 

319 

188 

Q 

SEG 

1.5 

1963 

1 

34.00 

14.00 

10.00 

9.00 

10.00 

11.00 

Q 

SEG 

1.5 

1963 

2 

30.00 

498 

678 

317 

262 

164 

POUDRE  RIVER  SEGMENT  1  SITE  4  FLOWS  (NOTE:  FLOWS  SAME  AS  1.5) 
SEG  1.4  DITTO  FROM  SEG  1.5 


POUDRE  RIVER  SEGMENT  1  SITE  1  FLOWS  (NOTE:  FLOWS  FROM  2.2) 


Q 

SEG 

1.1 

1954 

1 

55.00 

33.00 

33.00 

32.00 

28.00 

25.00 

Q 

SEG 

1.1 

1954 

2 

49.00 

414 

574 

245 

61 . 00 

96.00 

Q 

SEG 

1.1 

1955 

1 

81.00 

28.00 

17 . 00 

20.00 

16 . 00 

20.00 

Q 

SEG 

1.1 

1955 

2 

33.00 

356 

1016 

455 

252 

73.00 

Q 

SEG 

1.1 

1956 

1 

50.00 

39 . 00 

40 . 00 

28.00 

25.00 

31.00 

Q 

SEG 

1.1 

1956 

2 

58.00 

1174 

1456 

396 

188 

54.00 

Q 

SEG 

1.1 

1957 

1 

33.00 

20.00 

26.00 

21.00 

24 .00 

23.00 

Q 

SEG 

1.1 

1957 

2 

118 

57  3 

2272 

16  87 

328 

162 

Q 

SEG 

1.1 

1958 

1 

81.00 

45.00 

43 . 00 

34.00 

37.00 

43.00 

Q 

SEG 

1.1 

1958 

2 

182 

1497 

1602 

262 

66.00 

54.00 

Q 

SEG 

1.1 

1959 

1 

51.00 

31.00 

33.00 

27.00 

36.00 

50.00 

Q 

SEG 

1.1 

1959 

2 

202 

712 

1730 

400 

175 

68.00 

Q 

SEG 

1.1 

1960 

1 

73.00, 

63.00 

19.00 

17.00 

14.00 

49.00 

Q 

SEG 

1.1 

1960 

2 

93.00 

810 

1613 

450 

105 

71.00 

Q 

SEG 

1.1 

1961 

1 

49.00 

29.00 

25.00 

37 . 00 

30.00 

46.00 

Q 

SEG 

1.1 

1961 

2 

132 

1142 

1963 

520 

305 

196 

Q 

SEG 

1.1 

1962 

1 

264 

113 

52.00 

59,00 

103 

88.00 

Q 

SEG 

1.1 

1962 

2 

322 

1121 

1427 

748 

184 

37.00 

Q 

SEG 

1.1 

1963 

1 

62.00 

35.00 

29 .00 

18.00 

19.00 

12.00 

Q 

SEG 

1.1 

1963 

2 

67 .00 

444 

635 

199 

190 

124 

POUDRE  RIVER  SEGMENT  2  SITE  2  FLOWS 
SEG  2.2  DITTO  FROM  SEG  1.1 


Sample  ZMTSM  file  in  NWDC  format. 
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File  Format  for  a  ZMTSM  File 

Lines  1  and  2:  Title  lines  (80  characters  per  line) 
Line  3:  Gaging  station-segment  identifier 


Lines  4  through  N:  C^icm  1 — ^How  data.  There  are  2  lines 
for  each  year  of  flows,  formatted  as  follows: 


Columns 

Format 

Description 

(USGS  Format) 

9-16 

A8 

Segment  ID  number 

17-20 

14 

Year 

24 

11 

Data  indicator: 

1  =  first  set  (months  1-6), 

2  =  second  set  (months  7-12), 

25-66 

6F7.0 

Flows 

Columns 

Format 

Description 

(NWDC  Format) 

1-8 

A8 

Segment  ID  number 

13-16 

14 

Year 

17 

Blank 

18 

11 

Data  indicator: 

1  =  first  set  (months  1-6), 

2  *  second  set  (months  7-12). 

20-67 

6F8.0 

Flows 

Lines  4  through  N:  Option  2 — ^For  networks  in  which  flows 
do  not  change  appreciably  through  a  river  segment,  but 
the  habitat-versus-flow  relations  do  change  due  to  geo- 
morphic  features,  there  is  a  “ditto’’  option.  (This  line 
comes  after  a  line  with  the  segment  ID).  If  the  first  line 
of  flow  data  is 


Columns  Format  Description 
(USGS  Format) 


9-16 

A8 

Segment  ID  number 

17 

Blank 

18-27 

AlO 

DITTO  FROM  (upper  case) 

28 

Blank 

29-36 

A8 

Segment  ID  number  (segment 
from  which  to  be  copied). 

Columns 

Format 

Description 

(NWDC  Format) 

1-8 

A8 

Segment  ID  number 

9 

Blank 

10-19 

AlO 

DITTO  FROM  (upper  case) 

20 

Blank 

21-28 

A8 

Segment  ID  number  (segment 
from  which  to  be  copied) 

the  flow  data  will  be 

copied  from  the  segment  ID  entered. 

Note  that  DITTO  can  be  applied  to  a  previously  DITTOed 
segment — that  is,  suppose  the  file  looks  like  this: 

SEGMENTl 
flow  data 
SEGMENT2 
flow  data 
SEGMENTS 
flow  data 

SEGMENT4  DITTO  FROM  SEGMENTS 
SEGMENTS  DITTO  FROM  SEGMENT4 

then  both  segments  4  and  5  would  have  the  same  flow  data 
as  segment  3.  (Segment  5  could  have  said  DITTO  FROM 
SEGMENTS).  In  any  case,  DITTO  may  only  refer  to  a 
segment  previously  encountered  in  the  file. 

Lines  4  through  N:  Repeat  for  each  new  gaging  station- 
segment. 


Sample  Data  Sets 
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Modified  ZHAQF  File  Used  as  Input  to  the  HABNET  Program 

(Modified  Using  the  HQFMON  Program) 

ZHAQFM  =  default  filename 
HAQFM.DAT  =  sample  file  on  disk 


CACHE  LA  POUDRE  RIVER  FLOW  VS.  HABITAT  (WUA  SQ,  FT  PER  FT.)  FUNCTIONS 
SECOND  MAIN  TITLE  LINE 
POUDRE  RIVER  SEGMENT  1  SITE  5 
SEG  1.5 

brown  111111111111  0.0 

DISCHARGE  ADULT 

0.00  0. 

25.00  13000. 

50.00  16500. 

100.00  19400. 

200.00  19000. 

300.00  15000. 

500.00  10000. 

700.00  7900. 

900.00  6400. 

1000.00  5800. 

2000.00  4100. 

3000.00  4000. 

5000.00  4000.  Arbitrarily  extended 

********** 

POUDRE  RIVER  SEGMENT  1  SITE  5 
SEG  1.5 

BROWN  111111111111  0.0 

DISCHARGE  JUVENILE 

0.00  0. 

25.00  15000. 

50.00  21000. 

100.00  28000. 

200.00  25700. 

300.00  20200. 

500.00  14200. 

700.00  10200. 

900.00  7400. 

1000.00  7000. 

2000.00  4100. 

3000.00  3500. 

5000.00  3500.  Arbitrarily  extended 

********** 

POUDRE  RIVER  SEGMENT  1  SITE  5 
SEG  1.5 

brown  000000011110  0.0 

DISCHARGE  FRY 

0.00  0. 

25.00  ,  7200. 

50.00  11200. 

100.00  13900. 

200.00  13000. 

300.00  9500. 

500.00  5900. 

700.00  4700. 

900.00  3600. 

1000.00  3100. 

2000.00  2500. 

3000.00  2400. 

5000.00  2400.  Arbitrarily  extended 

********** 


Sample  ZHAQFM  file. 
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File  Format  for  a  ZHAQFM  File 

Lines  1  and  2:  Title  lines  (maximum  80  characters  per 
line). 

Line  3:  Extra  title  line  (optional).  Other  PHABSIM  appli¬ 
cations  may  require  that  this  title  line  be  deleted. 

Line  4:  Gaging  station/segment  identifier.  This  will  have 
to  match  exactly  with  the  segment  numbers  read  from 
the  gaging  station  data  (ZMTSM)  file  and  the  HABNET 
input  file  (ZHABIN).  Again,  other  PHABSIM  applica¬ 
tions  may  require  that  this  line  be  deleted. 

Line  5:  Species  data  line. 


ZTEMP  File  Used  as  Input  to  the 
HABNET  Program 
(Optional  Input)  This  file  may  be  in  two 
formats: 

(1)  USGS  or  NWDC  format — modifications  done  with 
an  editor. 


Note:  The  ZTEMP  file  (temperature  time  series  data  in 
USGS  or  NWE>C  format)  is  in  the  same  format 
as  the  ZMTSM  file  except  that  it  contains  tem¬ 
perature  data  instead  of  flow  data. 


Columns  Format 
1-10  10  Characters 
11-29 

30-41  A12 


42 

43-52  FIO.O 


Description 

Species  name 

Blank 

12  time  period  flags: 

1  if  applicable, 

0  if  not. 

These  values  are  necessary  at 
all  segments;  the  order  depends 
on  whether  it  is  a  water  year 
or  calendar  year. 

Blank 

Habitat  threshold — that  value 
(in  square  feet  x  1,000,  for 
example)  under  which  a  warn¬ 
ing  error  will  be  printed  if  the 
population’s  usable  area  falls 
below  it  for  any  month. 


53-80  Blank 


(2)  Free-formatted  file  containing  parameters  for  a 
temperature-versus-fiow  relation.  This  file  can  be 
created  with  the  QTEM  program  or  with  an  editor. 
Type  INFOTQ  for  on-line  information  on  the  for¬ 
mat  of  this  file. 


ZTEMP  default  filename 

TEMP1.DAT  =  sample  temperature  time 
series  data  in  NWDC 
format  on  disk 


Line  6:  Discharge  and  life  stage  data  line. 

Columns  Format  Description 
1-6  Blank 

7-15  9  Characters  DISCHARGE 
16-17  Blank 

18-27  10  Characters  Life  stage  name 
28-80  Blank 

Lines  7  through  N:  Discharge  and  weighted  usable  area 
data  (3X,  2F12.0)  followed  by  line  N  +  1  which  is 
**********,  end  of  logical  record. 


Repeat  lines  3-N  for  each  species-life  stage  in  the  file. 
The  format  repeats  for  each  new  segment.  The  time  and 
threshold  are  required  for  each  segment  because  they 
may  differ  throughout  the  network — that  is,  a  life  stage 
may  have  different  time  and  threshold  values  at  different 
geographic  points. 


Sample  Data  Sets 
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File  Format  for  a  FVee-formatted  ZTEMP 
File 

(Can  be  Created  by  the  QTEM  Program 
or  with  an  Editor) 

Lines  1 ‘3:  Title  lines  for  data 

Line  4:  The  letters  TQ  (upper  case)  in  colunms  1  and  2. 

Line  5:  Segment  ID  number  (maximum  8  characters). 
These  numbers  will  have  to  match  exactly  with  the 
segment  numbers  read  from  the  gaging  station  data 
(ZMTSM)  file,  the  HABNET  input  file  (ZHABIN),  and 
the  habitat  area-versus-flow  relation  file  (ZHAQFM). 

Lines  6  through  17:  Empirically  derived  parameters  to 
calculate  temperature  as  a  function  of  flow  for  each  of 
the  12  time  steps  per  year  at  each  geographic  location. 
Enter  one  line  for  each  time  period  containing  the  num¬ 
ber  of  the  time  period  and  the  four  empirically  derived 
temperature  versus  flow  parameters  (a,  b,  c,  d). 


where 


T/  =  calculated  temperature  for  time  step  i 
Qi,  bi,  c/,  di  -  empirically  derived  coefficients  for  time 
step  i 

log  Q|  =*  natural  log  (base  e)  or  discharge  Q  for  time 
step  i 

The  B-coefficient  term  will  only  be  valid  down  to  flows 
of  1  (cfs  or  cms).  If  flows  are  below  1,  the  whole  term  will 
drop  out  of  the  temperature  calculation  equation.  In  other 
words,  we  really  have  a  set  of  equations  that  looks  like  the 
following: 

IfQ>l, 

T  -  a  +  Z?  ln(Q)  +  c  (3^. 


T  =  +  c  Q^. 

Line  18:  **********  (lo  asterisks)  to  mark  the  end  of  a 
record. 


The  formulation  is: 

Ti  =  ai  +  bi  logQ/  +  a  0^^ 


Lines  19-N:  Repeat  the  segment  and  flow  parameters  line 
(lines  5-18)  for  each  segment. 


Temperature  (F)  versus  flow  (cfs)  file  for  Poudre  River  Network 
Water  year  organization 

Data  from  SSTEMP  approximations  (Temperature  predictions  in  Degrees  F) 


SEG  1.5 


1 

40.660 

1.470 

0.000 

0.000 

2 

22.920 

3.700 

0.000 

0.000 

3 

22.300 

3.510 

0.000 

0.000 

4 

22.160 

3.470 

0.000 

0.000 

5 

22.690 

3.630 

0.000 

0.000 

6 

27.860 

3.080 

0.000 

0.000 

7 

37.620 

1.850 

0.000 

0.000 

8 

58.000 

-0.610 

0.000 

0.000 

9 

70.230 

-2.000 

0.000 

0.000 

10 

74.600 

-2.490 

0.000 

0.000 

11 

69.320 

-1.900 

0.000 

0.000 

12  55.080 

********** 

-0.270 

0.000 

0.000 

SEG  3.3 

1 

48.330 

0.540 

0.000 

0.000 

2 

30.500 

2.740 

0 . 000 

0.000 

3 

22.870 

3.690 

0.000 

0.000 

4 

22.720 

3.640 

0.000 

0.000 

5 

27 . 180 

3.160 

0.000 

0.000 

6 

35.220 

2 . 150 

0.000 

0.000 

7 

51.050 

0.210 

0.000 

0.000 

8 

64.850 

-1.400 

0.000 

0.000 

9 

77.070 

-2.750 

0 . 000 

0.000 

10 

81.700 

-3.240 

0.000 

0.000 

11 

76.650 

-2.710 

0.000 

0.000 

12  62.660 

********** 

-1.150 

0 . 000 

0.000 

Sample  free-formatted  ZTEMP  file  created  with  an  editor. 
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ZTSI  File  Used  as  Input  to  the 
HABNET  Program 
(Optional  Input)  This  file  may  be  in  two 
formats: 

(1)  FISHCRV  format— created  with  the  GCURV  pro¬ 
gram  in  PHABSIM,  or 

(2)  Free-formatted  file,  containing  preference  curve 
data  for  each  life  stage.  This  file  is  created  with  an 
editor.  Type  INFOTSI  for  on-line  information  on  the 
format  of  this  file. 

ZTSI  =  default  filename 

TSI.DAT  =  sample  free-formatted  file  with 

temperature  suitability  index  criteria 
on  disk 

Note  that  the  free-formatted  temperature  data  are 
not  in  standard  PHABSIM  FISHCRV  data  for¬ 
mat.  It  was  decided  that  it  would  be  better  to  have 
the  chosen  format  for  the  following  reasons:  Few 
use  the  temperature  data  in  a  FISHCRV  file;  this 
format  is  easier  to  edit  and  visually  comprehend; 
there  are  no  restrictions  such  as  including  a  zero 
and  a  100  coordinate  pair  (however,  it  is  still  wise 
to  do  so);  and  other  things,  such  as  the  adjustment 
factor,  may  be  added.  This  file  contains  prefer¬ 
ence  curve  data  for  each  life  stage.  The  data  file 
is  organized  with  one  life  stage  per  record  (re¬ 
cord,  as  used  here,  means  life  stage),  with  re¬ 
cords  separated  by  at  least  10  asterisks 
^★*********y  A  sample  free-formatted  ZTSI 
file,  which  may  be  used  as  input  to  HABNET, 
follows. 


FUe  Format  for  a  Free-formatted  ZTSI  File 
(Created  with  an  Editor) 

Line  1:  Title  line  (up  to  80  characters) 

Line  2:  Species  and  life  stage  data: 

Columns  Format  Description 

1-10  10  Characters  Species  name  (left-justified) 

1 1-20  10  Characters  Life  stage  name  (left-justified) 
21-25  Blank 

26-28  3  Characters  MIN,  AVG,  or  MAX  (see  follow¬ 
ing  Note) 

29  Blank 

30-39  FIO.O  Temperature  adjustment  factor 

Lines  3  through  N:  Temperature  and  SI  data.  One  line  for* 

each  temperature,  in  ascending  order,  with: 


Columns 

Format 

Description 

1-9 

F9.0 

Temperature 

10-11 

Blank 

12-14 

F3.0 

Suitability  index  between  0.0 

and  1.0 

Line  N  +  1:  Logical  end  of  record  (**********) 

Lines  2  through  N  +  1:  Repeat  for  each  new  species-life 
stage. 

Note:  The  MIN,  AVG,  or  MAX  label  is  not  required  for 
the  HABNET  program.  It  is  required  for  compatability 
with  other  network  programs  and  it  is  required  that  you 
know  what  temperatures  are  supplied  or  calculated.  The 
adjustment  factor  allows  the  addition  of  a  constant  value 
to  the  calculated  or  supplied  temperature.  For  example, 
suppose  you  had  reason  to  believe  that  a  given  life  stage 
could  locate  a  microthermal  habitat  area  that  was  2° 
cooler  than  the  main  channel  temperature.  Supplying  a 
-2  in  the  temperature  adjustment  field  would  then  sub¬ 
tract  2°  from  the  supplied  or  calculated  temperature. 


Note:  A  format  of  Fx.O  means  that  you  may  either 
right-justify  an  integer  or  add  a  decimal.  Supply¬ 
ing  the  decimal  is  highly  recommended. 


TEMPERATURE  -  SUITABILITY  INDEX  FILE  FOR  POUDRE  RIVER.  DATA  FROM  RALEIGH 
BROWN  ADULT  AVG  0.0 

00.0  0.0 
32.0  0,0 

43.0  0.5 

54.0  1.0 

72.0  1.0 

75.0  0.0 

100.  0.0 
********** 

BROWN  JUVENILE  AVG  0.0 

00.0  0.0 
32.0  0.0 

43.0  1,0 

75.0  1.0 

79.0  0.0 

100.  0.0 
********** 
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Miscellaneous  Sample  Data  Files  Included 
on  the  Sample  Disk 

AQBKWAT.DAT  Annual  streamflow  file  containing 
annual  streamflow  data  for  the 
Black  River  at  Watertown,  New 
York,  that  was  used  as  input  to  the 
TRANTS  program. 

DQIN.DAT  Free-formatted  file  containing 

daily  streamflow  values.  This  file 
can  be  used  as  input  to  the  QIN 
program  to  create  a  daily  stream- 
flow  file  (ZDQ). 


MQSANCK.DAT  Monthly  streamflow  file  contain¬ 
ing  the  gaged  streamflow  data  for 
Sandy  Creek  near  Adams,  New 
York,  that  was  used  as  input  to  the 
TRANMR  and  TRANMN  pro¬ 
grams. 

S VR30.DAT  Monthly  time  series  file  containing 

reservoir  storage  volume  data  that 
was  used  as  input  to  the  RESYI 
program. 

ZRESIN.DAT  RESYLD  input  file  created  by  the 
RESIN  program. 
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Appendix  B.  Descriptions  of  Default  Filenames 


REELNO;  File  of  tape  reel  numbers  from  the  daily  values  backflle — generated  by  the  GETREL  program. 

WATDUR:  WATSTORE  duraticm  analysis  file  created  by  submitting  the  request  file  created  by  the  DURTBL 
program  to  WATSTORE. 

WATREQ:  WATSTORE  request  file  generated  by  the  DAILY,  DURTBL,  INVENT;  MESS,  and  PEAK  programs. 

WATMESS:  WATSTORE  message  file. 

ZANTS:  Annual  time  series  file;  may  contain  habitat,  streamflow,  temperature,  water  quality,  sediment,  and 
other  data. 

ZDQ:  Daily  streamflow  file  in  WATSTORE  format. 

ZHAQF:  Habitat  weighted  usable  area-versus-streamflow  (habitat-versus-flow). 

ZIN;  Input  file  (various  definitions). 

ZMONQ:  Monthly  streamflow  file  in  USGS  or  NWDC  format. 

ZMTS:  Monthly  time  series  file  in  USGS  or  NWDC  format;  may  contain  habitat,  streamflow,  temperature, 
water  quality,  sediment,  and  other  data. 

ZOUT:  PROGRAM  results. 

ZREDUR;  Reduced  WATSTORE  duration  analysis  file  created  by  the  SELDUR  program. 


TSLIB  Batch-Procedure  Files 
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Appendix  C.  Alphabetical  Summary  of  TSLIB 

Batch-Procedure  Files 


The  following  table  is  divided  into  five  columns.  The 
first  two  columns  list  the  program  name  and  the  batch 
filename  (procedure  filename  on  the  CDC)  used  to  execute 
it.  The  third  column  lists  the  function  classification  for  the 
program.  The  fourth  column  gives  a  brief  description  of 
the  function  of  the  program,  and  the  last  column  lists  the 
batch-procedure  name  and  shows  the  proper  order  of  the 
files.  The  names  of  these  files  are  the  default  filenames. 
Users  may  substitute  their  own  filenames  for  these  files. 
Note  that  on  the  micro,  commas  are  not  necessary;  they 
are  treated  as  blanks.  Therefore,  using  the  CDC  conven¬ 
tion  of  typing  ", (two  commas)  to  skip  over  a  file  will 
not  work.  Below  the  command  line  is  a  description  of  each 
file. 

Output  files  are  identified  by  "(output);”  input  files  are 
identified  by  "(input).  "Most  of  the  default  filenames  begin 
with  "Z"  to  avoid  writing  over  any  currently  existing  files. 
On  the  microcomputer  this  could  happen  easily,  since 


there  is  no  local  file  space,  as  on  the  CDC.  Users  should 
develop  a  convention  of  not  starting  their  filenames  with 
“Z  .  A  list  of  the  default  filenames  and  their  definitions 
can  be  found  in  Appendix  B. 

On  the  microcomputer  there  is  a  character  graphics  and 
a  screen  graphics  version  of  each  program  that  generates 
graphs  (i.e.,  LPTDUR  and  LPTDURG).  One  batch  file  is 
used  to  run  both  versions;  the  user  is  prompted  as  to 
whether  the  graphs  should  go  to  the  screea  If  ‘^es"  or  "Y" 
is  entered,  the  graphs  will  appear  on  the  screen  and  a  note 
stating  that  the  graph  was  sent  to  the  screen  will  be  written 
to  the  output  file  in  the  position  where  the  graph  would 
have  been  had  the  character  graphics  version  been  run.  If 
‘ho"  or  "N"  is  entered,  graphs  are  written  to  the  output  file 
in  a  132-character-per-line  format. 

To  run  the  screen  graphics  versions  of  the  plotting  pro¬ 
grams,  the  computer  must  have  a  color  graphics  adaptor 
(CGA)  or  compatible  graphics  card. 
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BATCH/ 

PROGRAM  PROCE3}UR£ 

NAME  Fn,ENAME  FUNCTION  DESCRIPTION  OF  FUNCTION 

INFODQ  Documentatioo  File  format  for  free-formatted  input 

file  to  QIN  to  create  a  daily  stream- 
flow  file  in  WATSTORE  format. 

INFOMQ  Documentation  File  format  for  free-formatted  input 

file  to  QIN  to  create  a  monthly 
streamflow  file  in  USGS  format. 

INFOTQ  DocumenUtioo  File  format  for  free-formatted  input 

file  to  HABNET  to  create  a  parame¬ 
ters  file  for  a  temperature  vs.  flow 
relationship. 

INFOTSI  Documentation  File  format  for  free-formatted  input 

file  to  HABNET  to  create  a  tempera¬ 
ture  suitability  criteria  file. 

ANEQTS  RANEQTS  Annual  Computes  monthly  and  annual 

Equivalent  equivalent  adult  habitat  time  series 

Adult  Habitat  for  one  species  with  up  to  five  life 
Time  Series  stages. 

Generation 


ANNTS  RANNTS  Annual  Creates  an  annual  time  series  file 

lime  Series  from  a  set  of  monthly  time  series 
Generation  data.  It  also  produces  an  output  file 
containing  tables  and  plots  of  the 
composite,  minimum,  and  maximum 
annual  time  series  values  and  a  table 
showing  duration  data  for  the  com¬ 
posite  indices. 

CEDUR  RCEDUR  Streamflow  Analyzes  a  daily  flow  file  and  pro- 

Data  duces  six  different  reports  including 

Listing  daily,  monthly,  and  yearly  data  sum¬ 

maries;  flow  exceedence  percent¬ 
ages  by  month  or  by  a  user-defined 
time  period;  and  percentage  ex¬ 
ceedence  flows  for  user-defined  per¬ 
centages. 

CHGFMT  RCHGFMT  Monthly  Changes  a  USGS  format  file  to  a 

Time  Series  NWDC  format  file  or  vice  versa. 
Manipulation 


CHGMIN  RCHGMIN  ZRESIN  File  Changes  the  minimum  flow  values 

Modification  for  the  river  at  the  dam,  the  pipe  at 
the  dam,  and  the  river  at  the  down¬ 
stream  control  point. 


DESCRIPTION  OF 
INPUT/OUTPUT  FILES 


RANEQTS,  ZHAQF,  ZMONQ,  ZOUT, 

ZMTS,  ZANTS 

ZHAQF  =  habitat  vs.  flow  file  for  one  species 
with  up  to  five  life  stages;  cannot  be 
multirecord  file  (input) 

ZMONQ  »  mcmthly  streamflow  file  in  USGS  or 
NWDC  format;  cannot  be  multi¬ 
record  file  (input) 

ZOUT  =  ANEQTS  results,  including  tables  and 
plots  (output) 

ZMTS  -  monthly  time  series  file  containing 

equivalent  adult  habitat  values  (output) 

ZANTS  =  aimual  time  series  file  containing  com¬ 
posite,  minimum,  and  maximum 
equivalent  adult  habitat  values  for 
each  year  (output) 

RANNTS,  ZMTS,  ZOUT,  ZANTS 

ZMTS  *  monthly  time  series  file  in  USGS  or 
NWDC  format;  can  be  multirecord 
file.  Usually  output  from  HABTD  or 
HABTS.  (input) 

ZOUT  «  ANNTS  results  (output) 

ZANTS  =  annual  time  series  file  (output) 


RCEDUR,  ZDQ,  ZOUT 
ZDQ  =  daily  streamflow  file  in  WATSTORE  for¬ 
mat  (input).  (This  file  must  have  been 
run  through  the  DQFY  program  to  re¬ 
move  incomplete  years  and  extra  title 
lines) 

ZOUT  *  data  summaries,  exceedence  percent¬ 
ages,  and  percentage  exceedence  flows 
(output) 

RCHGFMT,  ZMTS,  ZMTSN 

ZMTS  =  monthly  time  series  file  in  USGS  or 

NWDC  format,  can  be  multirecord  file 
(input) 

ZMTSN  =  new  monthly  time  series  file  in 
NWDC  or  USGS  format,  will  be 
multirecord  if  ZMTS  is  (output) 

RCHGMIN,  ZRESIN,  ZRESINN 
ZRESIN  *  RES  YLD  input  file  (input) 
ZRESINN  *=  new  RES  YLD  input  file  with 
modified  minimum  flow  values 
(output) 
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PROGRAM 

NAME 

BATCH/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPTION  OF  FUNCTION 

DESCRlPnONOF 
iNPUT/oumrr  files 

COMMTS 

RCOMMTS 

Monthly 

Time  Series 
Manipulation 

Sums  two  USGS  formatted  files 
month-by-month  with  given  weights. 

RCOMMTS,  ZMTSl,  ZMTS2,  ZMTSN 
ZMTSl  =  monthly  time  series  file  in  USGS  for¬ 
mat,  can  be  multirecord  (input) 

ZMTS2  *  monthly  time  series  file  in  USGS  for¬ 
mat,  can  be  multirecord  (input) 
ZMTSN  *  combined  monthly  time  series  file  in 
USGS  format  (output) 

COMHQF 

RCOMHQF 

ZHAQFFile 

Manipulation 

Sums  or  combines  habitat  area  data 
from  two  habitat  area  vs.  stream- 
flow  files.  Weighting  factors  are 
supplied  by  the  user  when  files  are 
combined.  The  weight  for  the  first 
file  must  be  less  than  or  equal  to  *1**. 
The  weight  for  the  second  file  is  as¬ 
sumed  to  be  **!*•  minus  the  first  file 
weight.  Any  number  of  ZHAQF 
files  may  be  combined  by  adjusting 
the  wei^ting  factors  and  running 
COMHQF  on  two  ZHAQF  files  at  a 
time. 

RCOMHQF,  ZHAQFN,  ZHAQF,  ZHAQF2, 
ZOUT 

ZHAQFN  *  summed  or  combined  habitat  area 
vs.  streamflow  file  (output) 

ZHAQF  *  habitat  area  vs,  streamflow  file  (input) 
ZHAQF2  “  habitat  area  vs.  streamflow  file 
(input) 

ZOUT  *  summed  or  combined  habitat  area  in 
tables  for  each  individual  life  stage 
(output) 

CRHAQF 

RCRHAQF 

ZHAQFFile 

Entry 

Creates  a  habitat  area  versus  stream- 
flow  file  in  the  same  format  as  cre¬ 
ated  by  the  habitat  simulation  pro¬ 
grams  in  PHABSIM,  The  program 
prompts  for  flows  and  weighted 
usable  areas  (WUA).  An  unlimited 
number  of  species,  each  with  from 

1-5  life  stages,  can  be  included. 

RCRHAQF,  ZHAQF 

ZHAQF  *  habitat  vs.  flow  file  (output) 

DAILY 

RDAILY 

Streamflow 

Data 

Acquisition 

Generates  a  “Mean  Daily  Stream- 
flow  Values”  request  file  to  retrieve 
data  from  the  WATSTORE  database. 

RDAILY,  REELNO,  WATREQ 

REELNO  =  file  of  tape  reel  numbers  from  the 
Daily  Values  backfile  (input).  This 
file  was  created  by  the  GETREL 
program. 

WATREQ  *  WATSTORE  request  file  to  obtain 
Mean  Daily  Streamflow  Values 
(output) 

DQDUR 

RDQDUR 

Daily  Habitat 
Probability 
Exceedence 
Generation 

Processes  a  WATSTORE  duration 
analysis  file  with  the  following 
options: 

0  -  class  distribution  statistics 

1  =  habitat  exceedence  values 

and  graphs,  and  class  distri¬ 
bution  statistics 

2  «  duration  percentages 

3  *  all  three. 

RDQDUR,  WATDUR,  ZOUT,  ZHAQF, 
ZCLASS,  ZEXPLT,  ZMONTH,  ZVAR, 
ZREDUR 

WATDUR  =  WATSTORE  duration  analysis  file. 

Can  be  directly  from  WATSTORE, 
or  the  reduced  file  created  by  the 
SELDUR  program  (input) 

ZOUT  S'  file  containing  list  of  headings  from  the 
duration  analysis  file  (output) 

ZHAQF  =  habitat  vs.  streamflow  file.  Only 

needed  if  Options  1  or  3  are  selected 
(input).  If  not  needed,  enter  ZZZ  for 
this  file. 

ZCLASS  =*  class  distribution  statistics,  created 
by  Options  0,  1,  and  3.  (output) 

ZEXPLT  =  file  containing  exceedence  plots, 

created  by  Options  1  and  3.  (output) 

ZMONTH  =  file  containing  monthly  exceed¬ 
ence  statistics,  created  by  Options 
1  and  3.  (output) 

ZVAR  -  file  of  percentage  exceeded  flows  and 
variation  ratios,  created  by  Options  2 
and  3.  (output) 

ZREDUR  =  reduced  WATSTORE  duraUon  anal¬ 
ysis  file.  Created  if  WATDUR  was 
directly  from  WATSTORE  (output) 
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PROGRAM 

NAME 


DQFY 


DQTOMQ 


DURTBL 


EFFHAB 


EFFHB2 


EFFIN 


BATCH/ 

PROCEDURE  DESCRIPTION  OF 

FILENAME  FUNCTION  DESCRIPTION  OF  FUNCTION  INPUT/OUTPUT  FILES 


RDQFY 


RDQTOMQ 


RDURTBL 


REFFHAB 


REFFHB2 


REFFIN 


Streamflow 

DaU 

Manipulati(»i 


Streamflow 

Data 

Manipulation 


Streamflow 

Data 

Acquisition 


Annual 
Effective 
Adult  Habitat 
Hme  Series 
Generation 


Annual 
Effective 
Adult  Habitat 
Time  Series 
Generation 


Annual 
Effective 
Adult  Habitat 
Time  Series 
Generation 


Removes  incomplete  years  from  a 
daily  streamflow  file  in  WAT- 
STORE  format  for  use  with  the  CE- 
DUR,  DQTOMQ  and  HABTD  pro¬ 
grams.  DQFY  also  removes  excess 
title  lines  (files  from  Hydrodata  con¬ 
tain  extra  title  lines). 

Reads  a  daily  streamflow  file  in 
WATSTORE  format  and  writes  a 
monthly  streamflow  file  in  NWDC 
format. 


Generates  a  *Daily  Streamflow 
Values  Duration  Table”  request 
file  to  retrieve  data  from  the 
WATSTORE  database.  The  retrieved 
data  can  be  used  as  input  to  the 
DQDUR  program. 


Calculates  an  effective  adult  habitat 
time  series  for  four  life  stages  of  a 
given  species. 


Calculates  an  effective  adult  habitat 
time  series  for  four  life  stages  with 
up  to  two  age  classes  for  fry  and  up 
to  three  age  classes  for  juvenile. 


Creates  an  input  file  for  the 
EFFHAB  program  from  user  input 
or  from  four  annual  habitat  time 
series  files. 


RDQFY,  ZDQ,  ZDQN 
ZDQ  *  daily  streamflow  file  in  WATSTORE 
format  (input) 

ZDQN  *  new  daily  streamflow  file  in 

WATSTORE  format  with  complete 
years  and  two  title  lines  (output) 


RDQTOMQ,  ZDQ,  ZMONQ 

ZDQ  *  daily  streamflow  file  in  WATSTORE 

format  (input).  This  file  must  have  been 
run  through  DQFY  to  remove  incom¬ 
plete  years  and  excess  title  lines. 
ZMONQ  *  monthly  streamflow  file  in  NWDC 
format  (output) 

RDURTBL,  REELNO,  WATREQ 
REELNO  =  file  of  tape  reel  numbers  from  the 
Daily  Values  backfile  (input).  This 
file  was  created  by  the  GETREL 
program. 

WATREQ  *  WATSTORE  request  file  to  obtain 
Daily  Streamflow  Values  Duration 
Table  (output) 

REFFHAB,  EFHABIN,  ZANTS,ZOUT 
EFHABIN  =  EFFHAB  input  file  created  by  the 
EFFIN  program  (input) 

ZANTS  =  annual  time  series  file  containing 

available  and  effective  adult  habitats 
(output) 

ZOUT  list  of  data  and  a  table  of  equivalent 
adult  habitats,  available  equivalent 
adult  habitat  used,  beginning  of  the 
year  adults,  and  the  effective  habitat 
time  series  (output) 

REFFHB2,  EFHBIN2,  ZANTS,  ZOUT 
EFHBIN2  =  EFFHB2  input  file  created  by  the 
EFF1N2  program  (input) 

ZANTS  =  annual  time  series  file  containing 

available  and  effective  adult  habitats 
(output) 

ZOUT  =  list  of  data  and  a  table  of  equivalent 
adult  habitats,  available  equivalent 
adult  habitat  used,  beginning  of  the 
year  adults,  and  the  effective  habitat 
time  series  (output) 

REFFIN,  EFHABIN,  ZANTSl,  ZANTS2, 
ZANTS3,  ZANTS4 

EFHABIN  =  EFFHAB  input  file  (output) 
ZANTSl  -  annual  habitat  time  series  file  for 
adults  (input) 

ZANTS2  =  annual  habitat  time  series  file  for 
spawning  (input) 

ZANTS3  =  annual  habitat  time  series  file  for  fry 
(input) 

ZANTS4  =  annual  habitat  time  series  file  for 
juveniles  (input) 

NOTE:  Input  files  must  contain  the  same 
number  of  years  of  data  and  cannot  be  mul¬ 
tirecord  files. 
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PROGRAM 

NAME 

BATCH/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPTION  OF  FUNCTION 

DESCRIPTION  OF 
INPUT/OUTPUT  FILES 

EFFIN2 

REFFIN2 

Annual 

Effective 

Adult  Habitat 
Time  Series 
Generation 

Creates  an  input  file  for  the  EFFHB2 
program  from  user  input  or  from 
four  or  five  annual  habitat  time 
series  files. 

REFFIN2,  EFHBIN2,  ZANTSl,  ZANTS2, 
ZANTS3,  ZANTS4,  ZANTS5 

EFHBIN2  =  EFFHB2  input  file  (output) 
ZANTSl  »  annual  habitat  time  series  file  for 
adults  (input) 

ZANTS2  =  annual  habitat  time  series  file  for 
spawning  (input) 

ZANTS3  =  annual  habitat  time  series  file  for  fry 
(input) 

If  five  input  files  are  being  used: 

ZANTS4  »  annual  habitat  time  series  rile  for 
second  fry  age  class  (input) 
ZANTS5  =  annual  habitat  time  series  file  for 
juveniles  (input) 

If  four  input  files  are  being  used: 

ZANTS4  =  annual  habitat  time  series  file  for 
juveniles  (input) 

NOTE:  Input  files  must  contain  the  same 
number  of  years  of  data  and  cannot  be  mul¬ 
tirecord  files. 


GETl 

RGETl  Time  Series 

Manipulation 

Extracts  records  from  a  multirecord 
file. 

RGETl,  ZIN,  ZOUT 

ZIN  =  multirecord  file  (input) 

ZOUT  =  file  with  selected  records  (output) 

GETREL 

RGETREL  Streamflow 

Data 

Acquisition 

Processes  the  WATSTORE  message 
file  (obtained  by  submitting  the  file 
created  by  the  MESS  program)  and 
generates  a  file  of  tape  reel  numbers 

RGETREL,  WATMESS,  REELNO 
WATMESS  *  WATSTORE  message  file  (input) 
REELNO  =  file  of  tape  reel  numbers  from  the 
Daily  Values  backfile  (output) 

from  the  Daily  Values  backfile.  This 
file  is  used  by  the  DAILY,  DUKTBL, 
and  INVENT  programs  when  gener¬ 
ating  a  request  job  from 
WATSTORE. 


HABINN 

RHABINN  HABNET 

Options 

File  Creation 

Builds  a  HABNET  options  file. 

RHABINN,  ZHABIN 

ZHABIN  =  HABNET  opdons  file  (output) 

HABNET 

RHABNET  Network-Wide 

Monthly 

Habitat 

Time  Series 
Generation 

Generates  a  network-wide  monthly 
habitat  time  series.  Habitat  values 
may  be  temperature  condidoned  at 
the  opdon  of  the  user. 

RHABNET,  ZHABIN,  ZMTS,  ZMTSM, 
ZHAQFM,  ZTEMP,  ZTSI,  ZOUT 

ZHABIN  =  HABNET  input  file  created  by  the 
HABINN  program  (input) 

ZMTS  =  habitat  time  series  data  (output).  Will 
be  in  the  same  format  as  ZMTSM. 

ZMTSM  =  modified  monthly  flow  time  series  in 
USGS  or  NWDC  format  (input).  Can 
be  a  multirecord  file, 

ZHAQFM  =  modified  habitat  area  vs.  stream- 
flow  file  with  month  indicators  and 
minimum  habitat  values  (input). 
This  file  can  be  created  by  die 
HQFMON  program. 

ZTEMP  =  temperature  lime  series  data  in  USGS 
or  NWDC  format  or  a  free-formatted 
file  with  parameters  for  a  temperature 
vs.  flow  relation  (optional  input). 

The  free-formatted  file  can  be  created 
with  the  QTEM  program  or  type 
INFOTQ  for  information  on  the  for¬ 
mat  of  the  free-formatted  file. 

ZTSI  =  network  temperature  suitability  criteria 
file  or  FISHCRV  file  with  temperature 
suitability  criteria  (optional  input).  Type 
INFOTSI  for  information  on  the  format 
of  the  network  temperature  suitability 
criteria  file. 

ZOUT  =  HABNET  results  (output) 
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PRCXJRAM 

NAME 

BATCH/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPnON  OF  FUNCTION 

DESCRIPTION  OF 
INPUT/OUTPUT  FILES 

HABOUT 

RHABOUT 

ZHAQFFile 

Listing 

Arranges  a  habitat  area  vs.  stream- 
flow  file  by  month  and  determines 
the  total  area  per  1000  feet  of  stream 
water  for  each  flow,  with  an  option 
to  compute  a  yearly  average  for  each 
flow.  HABOUT  also  computes  the 
adult  equivalent  habitat  for  each 
species. 

RHABOUT,  ZHAQFM,  ZOUT,  ZHAQFN 
ZHAQFM  **  habitat  vs.  flow  file  for  12  months 
(input).  Same  format  as  ZHAQF 
file  except  only  12  values  are 
entered,  one  per  month.  If  more 
than  12  values  are  in  the  input  file, 
only  the  first  12  are  read. 

ZOUT  =  HABOUT  results  (output) 

ZHAQFN  *  habitat  vs.  flow  file  with  adult 

equivalent  habitat  values  (output) 

HBOUTA 

RHBOUTA 

ZHAQFFile 

Listing 

Writes  the  data  from  a  habitat  area 
vs.  streamflow  file  into  a  format  that 
may  be  useful  for  report  purposes. 

RHBOUTA,  ZHAQF,  ZOUT 

ZHAQF  *  habitat  vs.  flow  file  (input) 

ZOUT  =  HBOUTA  results  (output) 

HABTD 

RHABTD 

Daily 

Habitat 

Time  Series 
Generation 

Calculates  the  time  series  of  daily 
habitat  values  and  converts  these  to 
monthly  habitat  time  series  using 
user-supplied  criteria. 

RHABTD,  ZHAQF,  ZDQ,  ZMTS,  ZOUT, 
DAYFL 

ZHAQF  *  habitat  vs.  flow  file  (input) 

ZDQ  =  daily  streamflow  file  in  WATSTORE 
format  (must  have  been  run  through 
DQFY  to  strip  incomplete  years  and 
excess  title  lines  (input) 

ZMTS  =  monthly  habitat  time  series  file  in 

NWDC  format,  one  logical  record  per 
life  stage  (output) 

ZOUT  ==  HABTD  results  (output) 

DAYFL  =  file  of  daily  habitat  values  in  either 
report  or  Lotus  1-2-3  format.  Created 
when  daily  habitat  values  are 
requested  (output) 

HABTS 

RHABTS 

Monthly 

Habitat 

Time  Series 
Generation 

Creates  a  monthly  physical  habitat 
time  series  file  for  multiple  species 
and  life  stages.  The  program  calcu¬ 
lates  monthly  habitat  values  at  the 
site,  using  linear  or  non-linear  inter¬ 
polation,  for  each  species/life  stage. 

RHABTS,  ZHAQF,  ZMONQ,  ZMTS,  ZOUT 
ZHAQF  =  habitat  vs.  flow  file  (input) 

ZMONQ  “  monthly  streamflow  file  in  USGS  or 
NWDC  format  (input) 

ZMTS  =  monthly  habitat  time  series  file  with 
multiple  records  in  the  same  format  as 
the  ZMONQ  file  (output) 

ZOUT  =  HABTS  results  (output) 

HAQINT 

RHAQINT 

ZHAQFFile 

Manipulation 

Uses  a  given  habitat  versus  stream- 
flow  file  to  estimate  habitat  for  dif¬ 
ferent  flows  by  interpolation. 

RHAQINT,  ZHAQFN,  ZHAQF 

ZHAQFN  =  habitat  vs.  flow  file  for  requested 
flows  (output) 

ZHAQF  =  habitat  vs.  flow  file  (input) 

HQFMON 

RHQFMON 

HABNET 

ZHAQFM 

File  Creation 

Adds  month  indicators  and  mini¬ 
mum  habitat  values  to  a  habitat  area 
versus  streamflow  file. 

RHQFMON,  ZHAQF,  ZHAQFM 

ZHAQF  *  habitat  area  vs.  streamflow  file 
(input) 

ZHAQFM  =  habitat  area  vs.  streamflow  file 
with  month  indicators  and  mini¬ 
mum  habitat  values  (output).  An 
extra  title  line  and  segment  ID  line 
can  also  be  added  if  they  were  not 
previously  entered  with  an  editor. 

INVENT 

RINVENT 

Streamflow 

Data 

Acquisition 

Generates  a  station  inventory  request 
file  to  “Inventory  Daily  Values 

Data”  from  the  WATSTORE  data¬ 
base. 

RINVENT,  REELNO,  WATREQ 

REELNO  =*  file  of  tape  reel  numbers  from  the 
Daily  Values  backfile  (input).  This 
file  was  created  by  the  GETREL 
program. 

WATREQ  =  WATSTORE  request  file  to  obtain 
an  inventory  of  Daily  Values  Data 
(output) 
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PROGRAM 

NAME 

BATCH/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPTION  OF  FUNCTION 

DESCRIPTION  OF 
INPUT/OUTPUT  FILES 

LPTDAN 

RLPTDAN 

Analyzing  and 
Displaying 
Annual  Hme 
Series  Data 

Reads  one  or  two  annual  time  series 
riles  and  writes  an  output  rile  con¬ 
taining  an  annual  duration  table 
showing  ordered  annual  data,  a  sum¬ 
mary  statistics  table  containing  aver¬ 
age,  median,  index-A,  index-B,  in- 
dex-C,  10%,  20%,  80%,  and  90%  ex¬ 
ceedence,  and  an  exceedence  plot. 

RLPTDAN,  ZOUT,  ZANTS,  ZANTS2 

ZOUT  *  LPTDAN  results  (output) 

ZANTS  *  axmual  time  series  file  (input) 

ZANTS2  *  second  annual  time  series  file  (input) 
NOTE:  Input  files  do  not  have  to  contain  the 
same  number  of  years.  Multirecord  files  may 
be  used. 

LPTDUR 

RLPTDUR 

Analysis  of 
Monthly  Time 
Series  Data 

Reads  one  or  two  monthly  time  se¬ 
ries  riles  and  creates  an  output  rile 
arranged  either  by  groups  of  months 
or  by  individual  months  containing 
annual  duration  tables  showing  or¬ 
dered  monthly  data  for  each  month 
or  group  of  months,  an  exceedence 
plot  for  each  month,  a  summary  sta¬ 
tistics  table  showing  average,  me¬ 
dian,  index-A,  index-B,  index-C, 

10%,  20%,  80%,  90%  exceedence, 
and  plots  showing  median,  average, 
change  in  median,  and  change  in 
average  for  the  two  data  sets. 

RLPTDUR,  ZOUT,  ZMTS,  ZMTS2 

ZOUT  =  LFTOUR  results  (output) 

ZMTS  =  monthly  time  series  file  in  USGS  or 
NWDC  format  (input) 

ZMTS2  =  second  monthly  time  series  file  in 
USGS  or  NWDC  format  (input). 
NOTE:  Input  files  do  not  have  to  be  In  the 
same  format  or  contain  the  same  number  of 
years;  however  they  must  begin  with  the  same 
month.  Input  files  may  be  multirecord. 

LPTHQF 

RLPTHQF 

ZHAQFFile 

Display 

Plots  the  habitat  vs.  flow  functions — 
one  species  per  page;  1-5  life  stages. 

RLPTHQF,  ZHAQF,  ZOUT 

ZHAQF  =  ^bitat  vs,  flow  file  (input) 

ZOUT  =  LPTHQF  results  (output) 

LPTQHA 

RLPTQHA 

Displaying 
Monthly  Time 
Series  Data 

Plots  monthly  habitat  area  or  stream- 
flow  from  one  or  two  monthly  time 
series  files,  approximately  five  years 
per  page.  Program  has  the  option  to 
plot  the  Y-axis  using  either  a  loga¬ 
rithmic  or  linear  scale.  If  the  mini¬ 
mum  data  value  is  less  than  the  maxi¬ 
mum  data  value  divided  by  50.0, 
then  the  Y-axis  is  logarithmic. 

RLPTQHA,  ZOUT,  ZMTS,  ZMTS2 

ZOUT  =  LPTQHA  results  (output) 

ZMTS  =  monthly  time  series  file  in  USGS  or 
NWDC  format  (input) 

ZMTS2  =  second  monthly  time  series  file  in 
USGS  or  NWDC  format  (input). 
NOTE:  Input  files  do  not  have  to  be  in  the 
same  format  or  contain  the  same  number  of 
years;  however  they  must  begin  with  the 
same  month.  Multirecord  files  may  be  used. 

LPTTSN 

RLPTTSN 

Displaying 
Monthly  Time 
Series  Data 

Reads  up  to  five  monthly  time  series 
files  in  USGS  or  NWDC  format  and 
plots  the  data  in  a  user-specified 
range  of  years.  Output  includes 
tables  and  plots. 

RLPTTSN,  ZOUT,  ZMTSl,  ZMTS2,  ZMTS3, 
ZMTS4,  ZMTS5 

ZOUT  =  LPTTSN  results  (output) 

ZMTS(l-S)  =  monthly  time  series  files  in  USGS 
or  NWIX^  format  (input). 

NOTE:  Input  files  do  not  have  to  be  in  the 
same  format  or  contain  the  same  number  of 
years;  however  they  must  begin  with  the  same 
month.  Multirecord  files  cannot  be  used. 

LSTDQ 

RLSTDQ 

Streamflow 

Data 

Listing 

Writes  a  file  containing  header  infor¬ 
mation  and  title  lines  or  information 
by  water  years  in  a  daily  streamflow 
file.  WATSTORE  files  may  contain 
several  data  sets  with  individual  title 
lines. 

RLSTDQ,  ZDQ,ZOUT 

ZDQ  =  daily  streamflow  file  in  WATSTORE 
format  (input) 

ZOUT  =  LSTDQ  results  (output).  If  filename  is 
not  specified  and  only  headers  are 
requested,  output  will  go  to  the  screen. 

MESS 

RMESS 

Streamflow 

Data 

Acquisition 

Generates  a  **WATSTORE  message” 
request  file  to  retrieve  data  from  the 
WATSTORE  database  for  use  with 
the  GETREL  program. 

RMESS,  WATREQ 

WATREQ  =*  request  file  to  obtain  WATSTORE 
message  file  (output) 

MRGHQF 

RMRGHQF 

ZHAQFFile 

Manipulation 

Extracts  up  to  five  life  stages  from 
one  or  two  habitat  versus  stream- 
flow  files  and  creates  a  new  habitat 
versus  streamflow  file. 

RMRGHQF,  ZHAQFN,  ZHAQF,  ZHAQF2 
ZHAQFN  =  habitat  vs.  streamflow  file  with 
selected  life  stages  (output) 

ZHAQF  =  habitat  vs.  streamflow  file  (input) 
ZHAQF2  =  habitat  vs.  streamflow  file  (input) 
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PROGRAM 

NAME 

BATCB/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPnON  OF  FUNCTION 

DESCRIPTION  OF 
INPUT/OUTPUT  FILES 

MTSLST 

RMTSLST 

Displaying 
Monthly  Hme 
Series  Data 

Produces  a  formatted  table  of 
monthly  time  series  values  and  their 
averages.  These  tables  are  useful  for 
exporting  to  Lotus  1-2-3  or  other 
application  programs. 

RMTSLST,  ZMTS,  OUTMON,  OUTAVG 
ZMTS  *  monthly  time  series  file,  can  be  multi¬ 
record  (input) 

OUTMON  -  table  of  time  series  data  li^ed 
monthly  fw  each  year  (output) 
OUTAVG  » table  of  average  monthly  and  coeffi¬ 
cient  of  variation  values  (output) 

MULHQF 

RMULHQF 

ZHAQFFile 

Manipulation 

Weights  individual  life  stages,  or 
multiplies/divides  habitat  values  in  a 
habitat  versus  streamflow  file  by  a 
constant. 

RMULHQF,  ZHAQFN,  ZHAQF 

ZHAQFN  *  habitat  vs.  streamflow  file  with 
adjusted  habitat  values  (output) 
ZHAQF  *  habitat  vs.  streamflow  file  (input) 

MULMTS 

RMULMTS 

Monthly 

Time  Series 
Manipulation 

Multiplies  all  the  data  in  a  monthly 
time  series  file  in  USGS  or  NWDC 
format  by  a  constant.  The  output  file 
is  in  the  same  format  as  the  input  tile. 

RMULMTS,  ZMTS,  ZMTSN 

ZMTS  “  monthly  time  series  file;  can  be  multi¬ 
record  file  (input) 

ZMTSN  *  new  monthly  time  series  file  after 
multiplication  (output) 

NRMHQF 

RNRMHQF 

ZHAQFFile 

Manipulation 

Normalizes  habitat  values  in  a  habi¬ 
tat  versus  streamflow  file  with  re¬ 
spect  to  a  given  discharge  and  the 
corresponding  area.  If  the  given  dis¬ 
charge  is  not  on  the  file,  it  will  be 
added  and  the  habitat  values  will  be 
calculated  by  interpolation  for  the 
discharge.  If  the  first  record  in  the  in¬ 
put  file  is  not  area,  the  user  will  be 
prompted  to  enter  the  area. 

RNRMHQF,  ZHAQFN,  ZHAQF 

ZHAQFN  *  normalized  habitat  vs.  streamflow 
file  (output) 

ZHAQF  =  habitat  vs.  streamflow  file  (input) 

PAGEBR 

RPAGEBR 

Streamflow 

Data 

Manipulation 

Prepares  a  WATSTORE  output  file 
(generated  using  the  request  file 
created  by  the  DAILY,  DURTBL, 
INVENT,  or  PEAK  programs)  for 
printing.  PAGEBR  inseits  a  printer 
control  character  at  points  where 
printing  should  begin  on  a  new  page. 

RPAGEBR,  ZIN,  ZOUT 

ZIN  =  WATSTORE  output  file  (input) 

ZOUT  =  WATSTORE  output  file  with  page 
breaks  (output) 

PEAK 

RPEAK 

Streamflow 

Data 

Acquisition 

Generates  a  *Teak  Streamflow 

Values*’  request  file  to  retrieve  data 
from  the  WATSTORE  database. 

RPEAK,  WATREQ 

WATREQ  =  WATSTORE  request  file  to  obtain 
Peak  Streamflow  Values  (output) 

QABSDY 

RQABSDY 

Water 

Resource 

Systems 

Analysis 

Subtracts  a  diversion  flow  by  day 
from  a  daily  streamflow  file,  while 
leaving  a  user-specified  minimum 
flow  in  the  main  stream. 

RQABSDY,  ZDQ,  ZDQD,  ZDQR,  ZOUT 

ZDQ  *  daily  streamflow  file  in  WATSTORE 
format,  or  a  free-formatted  file  with 
streamflows  and  dates  (input) 

ZDQD  =  diversion  streamflows  in  daily  flow  file 
format,  or  a  free-formatted  file  with 
diversion  flows  and  dates  (input) 

ZDQR  -  required  minimum  instream  stream- 
flows  in  daily  flow  file  format,  or  a 
free-formatted  file  with  required 
instream  flows  and  dates  (input) 

ZDQN  =  daily  streamflow  file  with  flows  left 
after  the  diversiem  (output) 

ZOUT  =  QABSDY  results,  including  annual 
shortages  and  diversions  (output) 

QABSMN 

RQABSMN 

Water 

Resource 

System 

Analysis 

Subtracts  a  diversion  flow  by  month 
from  a  monthly  streamflow  file, 
while  leaving  a  user-specified  mini¬ 
mum  flow  in  the  main  stream. 

RQABSMN,  ZMONQ,  ZMONQN,  ZOUT 
ZMONQ  =  monthly  streamflow  file  in  USGS  or 
NWDC  format  (input) 

ZMONQN  =  monthly  streai^ow  file  in  the 

same  format  as  the  ZMONQ  input 
file,  with  diversion  flows  sub¬ 
tracted  from  the  monthly  flows 
(output) 

ZOUT  =  QABSMN  results,  including  annual 
shortages  and  diversions  (output) 
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PROGRAM 

NAME 

BATCH/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPTION  OF  FUNCTION 

DESCRIPTION  OF 
INPUT/OUTPUT  FILES 

QKV 

RQIN 

Streamflow 

Data  Entry 

Creates  a  streamflow  data  file  in 
WATSTORE  or  USGS  format  from 
keyboard  entry  or  from  a  free- 
formatted  ASCn  file  created  with  an 
editor.  Type  INFODQ  or  INFOMQ 
for  information  on  the  format  of  the 
free-formatted  input  file  for  daily  or 
monthly  streamflow. 

RQIN,ZQFIL,ZQIN 

ZQFIL  *  daily  streamflow  file  in  WATSTORE 
format  or  monthly  streamflow  file  in 
USGS  format  (output) 

ZQIN  *  free-formatted  ASCII  text  file  contain¬ 
ing  responses  to  program  prompts.  If  no 
filename  is  entered,  keyboard  input  is 
assumed  (input) 

QTEM 

RQTEM 

HABNET 
ZTEMP  File 
Creation 

Generates  a  temperature  vs.  flow 
equation  file. 

RQTEM,  ZTEMP 

ZTEMP  *  free-formatted  flow  vs.  temperature 
equation  file  (output) 

RESIN 

RRESIN 

RESYLD  Input 
File  Creation 

Creates  an  input  file  for  the 

RESYLD  program  with  the  flows 
from  one  or  two  monthly  streamflow 
files  or  frxnn  user  input. 

RRESIN,  ZRESIN,  ZMONQ,  ZMONQ2 
ZRESIN  =  RESYLD  input  file  (output) 

ZMONQ  =  monthly  streamflow  file  in  USGS  or 
NWDC  format  (optional  input).  Res¬ 
ervoir  inflows  will  be  calcidat^ 
from  this  flow  file.  The  local  in¬ 
flows  can  also  be  calculated  from 
this  file  or  entered  manually. 
ZMONQ2  *  monthly  streamflow  file  in  USGS 
or  NWDC  format  (optional  input) 
Local  inflows  will  be  calculate 
from  this  flow  file  if  two  flow  files 
are  used  as  input. 

RESYI 

RRESYI 

Reservoir 

Yield  Index 
Computation 

Computes  the  yield  index  for  a  reser¬ 
voir  given  a  RESYLD  input  file  and 
a  monthly  time  series  file  with  reser¬ 
voir  surface  area  or  storage  volume 
values. 

RRESYI,  ZRESIN,  ZMTS,  ZMTSN,  ZANTS, 
ZOUT 

ZRESIN  =  RESYLD  input  file  (input) 

ZMTS  =  monthly  time  series  file  containing  res¬ 
ervoir  surface  areas  or  storage  volumes 
(input) 

ZMTSN  =  Monthly  time  series  file  containing 
reservoir  yield  index  values  (output) 
ZANTS  =  aimual  time  series  file  containing  res¬ 
ervoir  yield  index  values  (output) 
ZOUT  =  RESYI  results  including  area,  storage 
volume,  and  yield  index  (output) 

RESYLD 

RRESYLD 

Water 

Resource 

Systems 

Analysis 

Operates  a  single  reservoir  with 
monthly  flows  using  criteria  such  as 
the  maximum  and  tninimiim  flow  at 
the  reservoir  and  downstream,  down¬ 
stream  water  rights,  pipe  flow  from 
the  reservoir,  and  power  production. 

RRESYLD,  ZRESIN,  ZRES,  ZOUT 

ZRESIN  *  RESYLD  input  file  created  by  the 
RESIN  program  (input) 

ZRES  =  RESYLD  output  file  containing  pipe 

and  river  flows  from  the  reservoir,  river 
flow  downstream,  reservoir  storage,  in¬ 
flow,  elevation,  evaporation,  surface 
area,  unregulated  flow  downstream, 
downstream  water  rights,  and  power 
production  (output) 

ZOUT  =  RESYLD  results  (output) 

RSTOMQ 

RRSTOMQ 

RESYLD 

Output  File 

Converts  the  output  file  (ZRES) 
from  the  RESYLD  program  to  a 
multirecord  monthly  flow  file. 

RRSTOMQ,  ZRES,  ZMONQ 

ZRES  =  RESYLD  input  file  (input) 

ZMONQ  -  monthly  flow  file  in  USGS  or 

NWDC  format  (output) 

SCORTS 

RSCORTS 

Analysis  of 
Monthly  Time 
Series  Data 

Reads  a  monthly  time  series  file 
and  calculates  several  statistical 
parameters,  including  log  normal 
distribution,  and  lag  one  correlation 
coefficients. 

RSCORTS,  ZMTS,  ZOUT,  ZANTS 

ZMTS  =  monthly  time  series  file  in  USGS  or 
NWDC  format;  can  be  multirecord 
(input) 

ZOUT  =  SCOCTS  results  (output) 

ZANTS  =  average  of  12  montUy  values  for  each 
year  (output) 
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PROGRAM 

NAME 

BATCH/ 

PROCEDURE 

FILENAME 

FUNCTION 

DESCRIPTION  OF  FUNCTION 

DESCRIPTION  OF 
INPUT/OUTPUT  FILES 

SELDUR 

RSELDUR 

Streamflow 

Data 

Manipulation 

Takes  a  WATSTORE  duration  analy> 
sis  file  (created  by  submitting  the  re¬ 
quest  file  created  by  DURTBL  to 
WATSTORE)  and  creates  a  smaller 
file  with  the  same  information  which 
can  be  used  as  input  to  the  DQDUR 
program. 

RSELDUR,  WATDUR,  ZREDUR 

WATDUR  *  WATSTORE  duration  analysis  file 
(input) 

ZREDUR  *  reduc^  WATSTORE  duration  anal¬ 
ysis  file  (output) 

SELMTS 

RSELMTS 

Monthly 

Time  Series 
Manipulation 

Allows  selection  of  individual 
months  or  groups  of  months  from 
two  or  more  monthly  time  series 
data  files  to  create  a  single,  compos¬ 
ite  monthly  time  series  file. 

RSELMTS,  ZMTSN,  ZMTS 

ZMTSN  »  new  monthly  time  series  file  in  the 

same  format  as  the  input  files  (output) 
ZMTS  *  a  base  mtmthly  time  series  file  to  be 

used  as  a  building  block;  can  be  multi- 
record  (input).  User  will  be  prompted 
to  enter  filenames  for  other  ZMTS  files 
to  select  months  from. 

NOTE:  All  input  files  must  be  in  the  same 
format  (USGS  or  NWDC),  contain  the  same 
number  of  years,  and  be^  with  the  same 
month. 

SUMHQF 

RSUMHQF 

ZHAQFFile 

Manipulation 

Sums  conditional  cover  columns  in  a 
ZHAQF  file  into  one  habitat  versus 
flow  figure  for  each  life  stage.  Run 
when  conditional  cover  curves  were 
used  as  input  to  the  habitat  simula¬ 
tion  programs.  Allows  up  to  five  life 
stages  to  be  grouped  in  each  record. 

RSUMHQF,  ZHAQF,  ZHAQFN 

ZHAQF  *  habitat  vs.  streamflow  file  (input) 
ZHAQFN  =  modified  ZHAQF  file  with  col¬ 
umns  summed  (output) 

TRANTS 

RTRANTS 

Transferring 

Streamflow 

Data 

Transfers  an  annual  streamflow  file 
from  a  long  record  site  to  a  short 
record  site  using  the  equation: 

Qnew  =  A*(Qold)**B. 

RTRANTS,  ZANTS,  ZANTSN 

ZANTS  =  aimual  time  series  file  containing 
streamflow  data  from  a  long  record 
site  (input) 

ZANTSN  -  transferred  annual  time  series  file 
for  a  short  record  site  (output) 

TRANMN 

RTRANMN 

Transferring 

Streamflow 

Data 

Transfers  a  monthly  streamflow  file 
from  a  gaged  site  to  an  ungaged  site 
using  the  equation: 

Qnew  =  A*(Qold)**B 
with  options  to  use  different  A  and  B 
values  for  different  flow  ranges,  or 
to  compute  A  and  B  using  given  old 
and  new  flows. 

RTRANMN,  ZMONQ,  ZMONQN,  ZOUT 
ZMONQ  =  monthly  streamflow  file  (in  USGS 
or  NWDC  format)  for  a  gaged  site 
(input) 

ZMONQN  =  monthly  streamflow  file  with  cal¬ 
culated  flows  for  the  ungaged  site 
(output) 

ZOUT  =  TRANMN  results  (output) 

TRANMR 

RTRANMR 

Transferring 

Streamflow 

Data 

Transfers  a  monthly  streamflow  file 
for  a  gaged  (measured)  site  to  an  un¬ 
gaged  site  using  one  of  the  following 
methods:  (1)  drainage  area  ratio;  (2) 
drainage  area  and  precipitation  ratio; 
or  (3)  regional  statistics  method. 

RTRANMR,  ZMONQ,  ZMONQN,  ZOUT 
ZMONQ  =  monthly  streamflow  file  (in  USGS 
or  NWDC  format)  for  a  gaged  site 
(input) 

ZMONQN  =  monthly  streamflow  file  with  cal¬ 
culated  flows  for  the  ungaged  site 
(output) 

ZOUT  =  TRANMR  results  (output) 
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Appendix  D.  Installing  and  Running  PHABSIM 
_ and  TSIJB  on  a  Microcomputer 


Hardware  and  Software  Requirements 

To  run  the  PHABSIM  or  TSLIB  programs  on  a  micro¬ 
computer,  the  following  hardware-software  is  required: 

1.  IBM-compatible  microcomputer — ^AT  or  better  rec¬ 
ommended, 

2.  640K  of  available  RAM  memory,® 

3.  At  least  one  floppy  disk  drive, 

4.  MS-DOS  (PC-DOS)  version  3.00  or  later,  and 

5.  An  editor  with  ASCII  file  compatibility. 

The  following  are  highly  recommended  but  not  required: 

1 .  A  mass  storage  device  (i.e.,  a  hard  disk  or  a  Bernoulli 
box)  with  at  least  lOK  of  memory  (20K  would  be 
better), 

2.  An  8087  or  compatible  numeric  coprocessor — if  it  is 
present,  the  software  will  use  it;  if  it  is  not  available, 
it  will  be  emulated.  The  benefits  of  time  savings  from 
the  use  of  such  a  coprocessor  may  be  illustrated  by  run 
times  of  one  of  the  programs: 

With  8087  Without 

PC  (8088)  Architecture  12  s  263  s 

AT  (80286)  Architecture  4  s  75  s, 

3.  A  monitor  with  640  x  200  graphics.  To  run  screen 
graphics  versions  of  the  programs,  your  computer 
must  have  a  color  graphics  adaptor  (CGA)  or  compat¬ 
ible  graphics  card,  and 

4.  A  printer  with  graphics  capability  and  with  ability  to 
print  132  characters  per  line. 

Making  Copies  of  the  PHABSIM  or  TSLIB 
Diskettes 

This  write-up  assumes  a  minimal  working  knowledge  of 
MS-DOS.  It  is  left  to  the  user  to  decide  how  to  arrange 
MS-DOS  directories,  subdirectories,  and  paths  to  control 
proper  program  flow  with  the  desired  data  files.  It  may  be 
desirable  to  have  all  executable  programs,  batch  files,  and 
the  error  message  library  (RMFORT.ERR)  in  one  directory 
and  have  data  files  in  other  directories. 

We  have  chosen  the  following  conventions  for  naming 
files: 

[program  name]. EXE — ^Executable  program  file 
R[program  namej.BAT — ^Batch  file  for  controlling 
execution  of  a  program 
[filename]  .DOC  — ^Documentation 


1 .  Load  DOS  on  your  system. 

Whether  you  start  your  system  from  a  floppy  or  hard 
disk,  proceed  until  you  have  a  DOS  prompt  on  the 
screen. 

2.  Write-protect  your  distribution  diskettes. 

Use  a  write-protect  sticker  (or  opaque  tape)  to  cover 
the  small  cutout  area  of  the  diskette. 

3.  If  you  are  using  floppy  disks,  make  working  copies  of 
the  distribution  diskettes  using  the  DISKCOPY  com¬ 
mand  as  follows: 

A:\>DISKCOPYA:  B: 

Answer  the  diskcopy  prompts  that  appear.  If  asked,  the 
source  diskette  refers  to  the  distribution  diskettes  being 
copied.  The  target  diskette  is  the  diskette  that  will  become 
the  working  copy.  Label  your  working  copies  with  a 
felt-tipped  marker. 

If  you  are  using  a  hard  disk  drive,  create  a  subdirectory 
and  make  that  your  working  directory: 

C:\>MKDIR  [directory  name] 

C:\>CD  [directory  name] 

One  at  a  time,  copy  the  PHABSIM-TSLIB  distribution 
diskettes  to  this  directory  by  placing  the  source  diskette 
into  drive  A  and  enter  the  following  command. 

C:\>COPYA:*.* 

Note:  If  your  hard  disk  does  not  contain  enough  space 
to  hold  all  programs  at  once,  you  may  want  to 
put  on  just  the  category  of  programs  with  which 
you  are  working  at  the  time  (i.e,  daily  time 
series,  monthly  time  series,  etc.). 

4.  Put  the  write-protected  PHABSIM-TSLIB  distribu¬ 
tion  diskettes  in  a  safe  place. 

Distribution 

There  are  no  restrictions  on  the  distribution  of  the 
PHABSIM-TSLIB  programs.  We  ask  only  that  any  copies 
you  make  for  others  be  exact  duplicates  of  the  original 
diskettes  so  that  each  set  consists  of  unmodified  files. 

The  Preface  of  this  manual  and  the  file  MOU.TXT 
contain  a  copy  of  our  software  distribution  policy.  Please 
refer  to  them  for  more  information. 


®  Not  all  of  the  programs  require  640K  RAM  memory. 
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We  prefer  not  to  distribute  the  source  code  for  these 
programs  unless  the  need  dictates.  However,  the  source 
code  is  available.  PHABSIM-TSLIB  programs  arc  written 
in  Ryan-McFarland  FORTRAN  77.  Batch  files  are  written 
in  Microsoft’s  batch  language. 


Configuring  Your  System 

Before  running  PHABSIM-TSLIB,  you  must  first  mod¬ 
ify  or  create  a  CONFIG.SYS  file  to  enable  MS-DOS  to 
allocate  enough  room  for  the  data  files  used  by  the  pro¬ 
grams.  Specifically,  the  CONFIG.SYS  file  must  include 
the  following  statements: 

FILES-20 

BUFFERS  “2  0 

SHELL-X:\COMMAND.COM  /E:xxx  /P 

(where  X  =  drive  where  system  commands  are  stored, 

XXX  =  bytes  to  reserve  for  the  environment  block.) 

For  DOS  Version  3.2,  set  xxx  to  512. 

For  DOS  Versicm  3.0-3. 1,  set  xxx  to  32. 

The  SHELL*  statement  relates  to  environment  space. 
The  DOS  default  environment  space  is  160  characters. 
This  statement  allows  you  to  increase  the  environment 
space. 

The  AUTOEXEC.BAT  file  should  also  be  modified  or 
created  to  contain  the  following  statements: 

GRAPHICS  (or  whatever  graphics  printer  driver  you  have) 

PATH  drive:\[directory  name] 

SET  \RMFORT.ERR=\[directoiy  name]\RMFORT.ERR 

In  the  path  statement,  the  directory  name  should  be  the 
directoiy  where  the  PHABSIM-TSLIB  programs  are  lo¬ 
cated.  In  the  set  statement,  the  directory  name  should  be 
the  directory  where  the  RMFOKT.ERR  file  is  located  on 
your  system.  RMFORT.ERR  is  the  Ryan-McFarland 
FORTRAN  77  error  message  file. 


Similarities  and  Differences  with 
Mainframe  PHABSIM-TSLIB 

1.  Since  XEDIT  is  not  available  for  micros,  we  have 
assumed  that  all  users  will  have  their  own  editor  (or 
word  processor)  for  simple  editing  tasks.  We  can 
supply  a  shareware  screen  editor,  WED,  if  needed. 

2.  The  FORTRAN  line  printer  carriage  control  conven¬ 
tion  of  using  a  “Pin  column  1  to  go  to  the  top  of  the 
next  page  has  been  replaced  with  the  more  standard 
(but  not  completely  standard)  control-L  or  form-feed 
character.  Most  micro  printers  will  behave  appropri¬ 
ately.  If  for  some  reason  your  printer  does  not  perform 
as  expected,  you  could  use  your  editor  to  globally 
replace  all  control-Ls  with  whatever  you  need. 


3.  Similarly,  many  program  output  files  are  written  for 
wide  carriage  (132  column)  output  capability.  Most 
narrow  carriage  printers  will  emulate  a  wide  carriage 
by  sending  a  special  control  (escape)  sequence  or  by 
pressing  certain  buttons  on  the  printer.  Most  typically 
this  sends  the  printer  into  a  17-characters-per-inch 
mode  to  fit  132  columns  into  a  smaller  area.  Our 
programs  will  not  control  this  feature.  It  is  your  re¬ 
sponsibility.  We  can  supply  utility  programs  for  most 
Epson-  or  Hewlett-Packard-compatible  printers.  Ask 
us  about  SETUP.  Also,  we  have  the  LIST  utility  that 
is  good  for  looking  at  132-column  output  on  your 
80-column  screen. 

4.  The  microcomputer  version  of  the  PHABSIM- 
TSLIB  programs  differ  from  their  Cyber  counterparts 
in  that  they  do  not  have  a  “?”  prompt. 

5.  Mainframe  computers  have  different  ways  of  prema¬ 
turely  halting  program  operation.  Typing  STOP,  %2, 
<CR>,  and  Control-T  have  all  been  replaced  on  the 
microcomputer  by  typing  Ctrl-Bieak. 

6.  Because  the  number  of  significant  digits  maintained 
by  a  microcomputer  and  by  a  CDC  mainframe  differ, 
it  is  inevitable  that  calculations  that  involve  very 
small  numbers  may  produce  slightly  different  results. 
This  difference  may  cause  single  points  on  a  graph  to 
be  one  plot  position  different.  However,  this  does  not 
affect  the  usefulness  of  the  graphs  generated  on  a 
microcomputer. 

7.  Unformatted  files  such  as  TAPE3,  TAPE4,  TP4, 
FISHFIL,  and  ZHCF  (in  PHABSIM)  are  likely  to  be 
incompatible  between  a  microcomputer  and  the  CDC 
mainframe  and  between  different  microcomputers. 
The  formatted  version  of  the  files  should  be  used 
when  transferring  from  computer  to  computer. 

8.  On  the  microcomputer,  there  is  a  character  graphics 
and  a  screen  graphics  version  of  each  program  that 
generates  graphs  (i.e.,  LPTDUR  and  LPTDURG). 
One  batch  file  is  used  to  run  both  versions;  the  user  is 
prompted  as  to  whether  the  graphs  diould  go  to  the 
screen.  If  “Yes“  is  entered,  the  graphs  will  appear  on 
the  screen  and  notes  will  be  written  to  the  output  file 
in  the  positions  where  the  graphs  would  have  been 
written  if  the  character  graphics  version  had  been  run. 
If  “No”  is  entered,  graphs  are  written  to  the  output  file 
in  a  132-characters-per-line  format. 

To  run  the  screen  graphics  version  of  the  plotting  pro¬ 
grams,  the  computer  must  have  a  color  graphics  adaptor 

(CGA)  or  compatible  graphics  card. 
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Graphics  for  the  Hewlett-Packard 
Laser  Jet  Printer 

To  set  the  character  size  for  character-based  graphs  using 
an  HP  Laser  Jet  Printer,  the  font  must  be  changed  by  a 
series  of  printer  commands.  Printing  the  commands  will 
cause  the  printer  to  read  the  commands  and  change  fonts. 
The  commands  are  described  in  Chapter  3  of  the  LaserJet 
Printer  User's  Manual. 

To  set  the  printer  for  one  graph  per  page,  the  character 
size  must  be  changed  by  the  command 

<ESC>(sl6.66H 

where  <ESC>  =  the  escape  key.  This  command  sets  the 
printer  for  128  characters  per  line. 

The  printer  may  also  be  set  to  increase  the  number  of 
lines  per  inch,  so  that  comments  may  be  printed  above  or 
below  the  graph,  or  more  than  one  graph  may  be  printed 
on  a  page. 

To  set  the  number  of  lines  per  inch,  the  command  is 

<ESC>&1#D 

where  #  =  the  number  of  lines  per  inch.  The  value  for  # 
may  be  1, 2,  3, 6,  8, 12, 16, 24,  or  48. 

#  ===  8  is  recommended  for  comments  above  or  below 
the  graph, 

#  =  12  will  print  2  graphs  per  page,  but  lines  may  be 
hard  to  read. 

To  set  the  printer  back  to  the  original  font  the  command 
is 

<ESC>E 

Some  editors  may  not  recognize  the  escape  key,  and  many 
editors  will  show  different  characters  for  the  escape  key. 
The  WED  editor  uses  a  left  arrow  to  show  the  escape  key. 

It  is  recommended  that  frequently  used  font  commands 
be  written  to  a  file  so  the  file  can  be  sent  to  the  printer  each 
time  the  font  needs  to  be  changed.  The  printer  will  output 
a  blank  page  when  the  file  of  commands  is  printed.  An¬ 
other  file  should  be  created  with  the  escape  E  (<ESC>E) 
command  to  set  the  printer  back  to  default  fonts.  To  change 
the  font  while  printing  the  output  file,  the  commands  may 
be  added  directly  to  the  output  file.  Adding  the  commands 
to  the  output  will  allow  printing  of  reduced-size  graphs  and 
normal-size  text  on  the  same  page.  Remember  to  set  the 
printer  back  to  the  default  fonts  before  printing  other 
documents. 


Running  PHABSIM-TSLIB 
Using  Batch  Files 

Batch  files  contain  sets  of  several  system  commands 
arranged  to  perform  a  specific  task.  To  run  a  batch  file,  type 
the  batch  filename  and  then  the  appropriate  input  and  output 
filenames,  separated  with  a  space  or  a  comma.  The  batch 
filename  is  usually  the  program  name  preceded  by  “R”. 

Typing  just  the  batch  filename  gives  information  on  the 
function  of  the  program  and  (or)  batch  file,  substitution 
order,  default  input  and  output  filenames,  and  the  descrip¬ 
tion  of  what  the  input  and  output  files  contain.  Appendix 
C  contains  an  alphabetical  listing  of  all  the  batch  files  with 
this  information. 

Example:  RHABTD 

Program  HABTD  determines  the  time  series  of  daily 
habitat  values  and  converts  these  to  monthly  time  series 
habitat  data  from  user-supplied  criteria. 

RHABTD,  ZHAQF,  ZDQ,  ZMTS,  ZOUT,  DAYFL 
where 

ZHAQF  =  Habitat  area-versus-streamflow  file  (input). 

ZDQ  =  Daily  streamfiow  file  in  WATSTORE  format 
(input).  This  file  must  have  been  run  through 
DQFY  to  strip  incomplete  years  and  excess 
title  lines. 

ZMTS  =  Monthly  habitat  time  series  file  in  NWDC 
format,  one  logical  record  per  life  stage  (out¬ 
put). 

ZOUT  =  HABTD  results  (output). 

DAYFL  =  File  of  daily  habitat  values  in  either  report  or 
LOTUS  1-2-3  format.  Created  when  daily 
habitat  values  are  requested  (output). 


Notes  on  Entering  Data 

The  following  data  entry  alternatives  can  be  used  when 
prompted  to  enter  a  list  of  numbers  or  coordinate  pairs:  (1) 
Each  number  may  be  entered  on  a  separate  line,  (2)  a 
comma  or  one  or  more  spaces  may  be  used  as  the  delimiter, 
or  (3)  a  combination  of  commas  and  spaces  may  be  used. 
Examples  of  monthly  streamfiow  values  entered  in  the 
QIN  program  follow. 

•  Entered  on  a  separate  line 

523 — 1st  month 
479 — ^2nd  month 
715 — 3rd  month 
865 — 4th  month 
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•  Separated  by  commas 

523,479,715, 854, 

•  Separated  by  spaces 

523  479  715  854.. 


Runtime  Error  Messages 

When  an  error  occurs  you  ^ould  get  a  message  like  the 
following: 

Error  at  line  ###  in  program  name  Error  number  #### 
(the  error  message) 

If  you  only  get  numbers,  make  sure  the  command, 
as  described  in  the  “Configuring  your  system — 
AUTOEXEC.BAT  section^ET  RMFORT.ERR  =  \  [di¬ 
rectory  name]\RMFOKr.ERR”  is  set  to  the  directory  con¬ 
taining  RMFOKTERR. 

The  following  is  a  list  of  common  errors  that  could  occur 
when  running  the  programs.  Also  included  are  explana¬ 
tions  and  suggested  remedies  to  the  situations. 

-1  READ  PAST  END  OF  FILE:  An  attempt 
was  made  to  read  past  the  end  of  a  file. 
Check  the  input  file. 

2015  OPEN  STATUS  is  OLD  but  file  does  not 
exist:  The  input  file  specified  does  not  exist. 
Check  path  and  spelling. 

2514  Incorrect  integer  input:  A  character  or  real 
number  was  read  for  integer  input.  This  can 
occur  either  in  response  to  a  prompt  or  when 
an  input  file  has  the  wrong  format. 

25 17  Incorrect  integer  character:  A  character  was 
read  for  numeric  input. 

2519  Incorrect  exponent  in  input:  A  character 
was  read  for  numeric  input.  It  is  common 
that  your  input  file  mistakenly  has  an  1  (“el”) 
instead  of  a  1  (“one”),  or  an  O  (“oh”)  instead 
of  a  0  (“zero”). 


3012  File  opening  failure:  This  error  usually 
indicates  that  a  file  cannot  be  found  in 
the  current  directory  or  on  the  directory 
specified  when  entering  the  filename  (i.e., 
d:\  data  \  i4data). 

3023  End  of  file  before  new  line  on  reading  for¬ 
matted  sequential  record:  Read  an  end-of- 
file  marker  from  input  file  when  it  was 
expecting  more  input.  Check  format  of  in¬ 
put  file.  If  you  are  using  the  WED  editor, 
the  file  must  have  a  carriage  return  as  the 
last  line  to  properly  mark  end  of  file. 

3033  Write  error  on  formatted  sequential  record: 
Check  to  see  if  disk  is  full.  Delete  some  files 
or  try  running  on  the  hard  disk. 

3087  Read  error  on  formatted  sequential  record: 
Check  the  format  of  your  input  file. 

4002  Incorrect  DOS  version:  Your  version  of 
DOS  is  earlier  than  3.00.  Replace  it  with 
DOS  3.00  or  later  version. 

Out  of  environment  space:  The  DOS  environment  mem¬ 
ory  limitation  has  been  exceeded.  See  section  ‘C!onfigur- 
ing  Your  System”  (Appendix  D)  to  see  that  you  have 
environment  space  set  according  to  the  version  of  DOS 
you  are  using.  If  so,  shorten  your  PATHs  and  any  other 
unnecessary  SETs.  The  environment  is  set  by  your  AUTO¬ 
EXEC.BAT  file  each  time  you  boot-up  the  system.  To  look 
at  this  environment,  type  SET  carriage  return.  To  shorten 
PATHS,  retype  the  path  line  with  only  paths  needed  to  run 
PHABSIM-TSLIB  programs  followed  by  a  carriage  re¬ 
turn.  To  remove  SETs,  type  SET  name=carriage  return. 

If  you  are  having  trouble  running  a  PHABSIM-TSLIB 
program,  try  changing  ECHO  OFF  at  the  beginning  of  the 
associated  batch  file  to  ECHO  ON.  This  will  allow  you  to 
follow  the  (rather  complex)  series  of  commands,  and 
possibly  help  you  to  discover  your  (or  our)  mistake.  A 
“Qrl  S”  will  stop  scrolling  on  the  screen  so  that  you  can 
see  what  is  happening;  ‘Otrl  Q”  will  start  scrolling  again. 
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Appendix  E.  Running  PHABSIM  and  TSLIB 
_ on  a  CDC  Cyber  Computer 


The  Physical  Habitat  Simulation  System  (PHABSIM) 
and  the  Time  Series  Library  (TSLIB)  programs  are  cur¬ 
rently  maintained  on  the  following  Control  Data  Corpora¬ 
tion  (CDC)  Cyber  mainframe.  For  information,  contact 

U.S.  Bureau  of  Reclamation 
Division  of  Data  Processing 
User  Support  Branch 
PO.  Box  25007,  DFC 
Denver,  CO  80225 

(303)  236-9334  or  FTS  776-9334 

The  USBR  computer  system  is  limited  to  use  by  Gov¬ 
ernment  agencies  and  does  not  solicit  commercial  ac¬ 
counts. 

Logging  On  to  the  USBR  Cyber  Computer 

Turn  on  your  terminal  and  modem  and  dial  the  computer 
(USBR— 303,236-4601,  or  FTS— 776-4601).  At  the 
sound  of  the  high-pitched  tone,  place  the  telephone  in  the 
modem.  The  carrier  light  should  go  on.  If  it  is  not  lit,  then 
a  connection  to  the  host  computer  was  not  made.  Hang  up, 
redial,  and  try  again. 

When  the  carrier  light  is  lit  and  CONNECT  appears  on 
the  screen,  press  the  return  key  at  least  twice.  The  com¬ 
puter  will  then  display  information  regarding  the  system 
to  which  you  have  connected. 

•  A  carriage  return  follows  each  line  of  information 
you  enter. 

•  Guard  your  password,  as  it  is  the  only  protection  you 
have  for  your  account.  That  is  why  the  computer  auto¬ 
matically  oveistiikes  the  area  in  which  you  type  it. 

•  Write  down  your  JSN  in  case  it  is  needed  later  to 
recover.  In  the  following  examples,  the  JSN  is 
XXXX,YYY. 

WELCX»iE  TO  tttE  B.O.R.  NBIWRIC  F/SjC 

SYSTEMS  TE&SEim,y  AVAILABLE  ABE; 


^♦SYSTEM**  **MAME** 

C^EBS  CAA  OB  EE)  CVB 

VAX  8300" S  «3P0 

SVAX-IDS  LDS 


TO  SELECT  A  SYSTEM,  EKTEB  THE  SYSTEM 
NAME  AND  CARRtAOE  RBtURK  AT  NEXT 
PROMPT. 

CHANNEL  02/l2€.  ESTER  RESOORCE _ 


You  would  enter  CYB  here  and  then  press  the  car¬ 
riage  return  a  few  times. 

CONNECTED  TO  04/063  ^ 

HQ  HOST  SELECTED  CONTROL  CHARACTER^  <ESCI 
HPCr  NODE*  $  TERMIMAL  HAME«  TUK2Z 
HOST  NODE  SELECTED/  STATUS 

CONHECTED 

AA  IS  AVAILABLE 

Tm  vy  AVAILABLE 

ENTER  (ESe)HKsNODE  JBWBER  OR 
(ESC}KS«HAMS  TO  SELECT  HOST 


Press  ESC,  type  HS=EE  and  then  press  the  carriage 
return  a  few  times. 


HOST  MODE  SELECTED/  STATUS 
CONNECTED 

AA  16  AVAILABLE 
EE  17  S  AVAILABLE 
ENTER  INPUT  TO  CONNECT  TO  HOST 


Press  the  carriage  return  a  few  times. 


WELCOME  TO  THE  NOS  SOFTWARE  SYSTEM « 

COPYRIGHT  CONTROL  DATA^  1978^  1987. 

08/01/26.  10.S2>0$,  tl2K22 

CYBER  170/  875  EE  NOS  2,5  PRODUCTION.  USBR  >  V71122. 

USER  NAME;  lEnter  your  account  ucer 

PASSWORD; _ [Enter  yout  AcOCtmt  pao 8 Vox dl 


With  a  proper  log-in,  the  computer  will  respond: 


YOUR  PASSWORD  WILL  BE  EXBIRED  [year,  month,  and  date] 
JSN;  XXXX,YYY 

TiOi  [Enter  yout  tettoinAl  ID 

LAST  MOTD  REVISION  DATE  -  01-2$  *68*  D83Q  HOURS 

DO  YOU  WANT  TO  SEE  THE  MESSAGE  OP  THE  DAY7  <Y  OR  N) 


Type  in  BAT  to  move  you  into  the  batch  subsystem. 


^RPL.O. 

J_ _ 

When  the  prompt  is  on  the  screen,  you  have  success¬ 

fully  logged  on  to  the  USBR  Cyber  computer. 


Running  PHABSIM-TSLIB  and  Using 
Procedure  Files 

After  logging  on  to  the  computer,  the  user  must  transfer 
the  following  files  into  his  local  file  space.  It  is  not  recom¬ 
mended  that  they  be  stored  as  permanent  files,  as  the  user 
would  then  have  to  pay  storage  costs  and  may  not  have 
current  versions  of  programs  or  procedures. 
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USBR-PHABSIM 

/am » KH?kBFRc/0»«m4  D  22 
/LIBRARY  *  PHABPRC 


USBR-TSLIB 

/Ll&RARY,tgPROC _ 

PHABPRC  and  TSPROC  contain  the  procedure  files 
that  have  been  developed  to  assist  the  user  in  running  the 
PHABSIM  and  TSLIB  programs.  Procedure  files  contain 
sets  of  several  system  commands  arranged  to  perform  a 
specific  task. 

To  run  a  procedure,  type  the  procedure  name  and  then 
the  appropriate  input  and  output  file  names,  separated  by 
a  comma.  The  procedure  name  is  usually  the  program 
name  proceeded  with  R. 

Example:  RIFG4,  ZIFG4,  ZOUT,  TAPES,  TAPE4, 

TP4,  ZVAFF,  Z  VCEF 

On  the  Cyber,  a  “ ,  ”  (comma)  may  be  entered  if  the 
default  filename  is  being  used. 

Example:  RIFG4, 14DATA,  IFG40UT; , ,  ZVAFFl 

Typing  just  the  procedure  name  gives  information  on  the 
function  of  the  program  or  procedure,  substitution  order, 
default  input  and  output  filenames,  and  description  of  what 
the  input  and  output  files  contain.  Appendix  C  contains  an 
alphabetical  listing  of  all  the  procedures  with  this  informa¬ 
tion. 

Example:  RIFG4 

Program  IFG4  uses  a  stage-discharge  relation  to  deter¬ 
mine  water  surface  elevations  unless  they  are  supplied  in 
the  data  set.  When  using  the  stage-discharge  relation,  each 
cross  section  is  treated  independently  of  all  others  in  the 
data  set.  The  velocities  are  determined  using  techniques 
based  on  Manning’s  Equation. 

RIFG4,  ZIFG4,  ZOUT,  TAPE3,  TAPE4,  TP4, 

ZVAFF,  ZVCEF 

where 

ZIFG4  IFG4  data  set  (input), 

ZOUT  =  IFG4  results  (output), 

TAPE3  “  unformatted  cross  section  and  reach  data 
(output), 

TAPE4  **  unformated  flow  data  (output), 

TP4  =  rearranged  TAPE4  file  of  unformatted  flow 
data  (output), 

ZVAFF  *  velocity  adjustment  factor  file;  created  if 
IOC(13)  =  1  (output),  and 

ZVCEF  =  velocity  calibration  errors  file;  created  if 
lOC(lO)  =  1  (output). 


Notes  on  Entering  Data 

The  following  data  entry  alternatives  can  be  used  when 
requested  to  enter  a  list  of  numbers  or  coordinate  pairs:  (1) 
Each  number  may  be  entered  on  a  separate  line,  (2)  a 
comma  or  one  or  more  spaces  may  be  used  as  the  delimiter, 
or  (3)  a  combination  of  commas  and  spaces  may  be  used. 
Examples  of  coordinate  pair  entry  follow. 

•  Entered  on  a  separate  line 
0.00 — velocity 

1.00 — ^index 
1.00 — ^velocity 
0.25 — ^index 

•  Separated  by  commas 

0.00, 1.00 

1.00, 0.25 

•  Separated  by  commas  and  spaces  and  entered  on  the 
same  line 

0.00, 1.00  1.00, 0.25 

Job  Recovery 

When  logging  on  to  the  computer,  write  down  the  job 
serial  number  (JSN).  If  communications  between  your 
terminal  and  the  computer  are  interrupted,  or  if  the  com¬ 
puter  logs  you  off  (this  occurs  when  the  terminal  has  been 
idle  for  10  min),  you  may  recover  the  work  you  were  doing 
if  you  know  the  JSN  (XXXX  in  the  previous  examples). 

To  recover,  call  back  within  30  min  and  log  on  to  the  host 
computer.  After  the  computer  information  or  note,  you 
will  get  a  listing  of  recoverable  jobs. 

RECOVERABLE  JOB(S) 


UJN 

STATOS 

TIMECOT 

XXXX 

AAAA  ODDD 

it  ie 

tjerinanetitiy 

dropped^ 

SOSPEKDEff;:^ 

SOSPENDED 

26  MIN. 

MIN. 

ttiei©  left  to 
jcecovet 

EWTER  GO  TO  CC^mNOB  CORREWT 
REtlST  TO  ttST  recoverable 

OR  DESIRED  JSN: 

Entering  the  JSN  of  the  desired  job  will  recover  the  job 
and  place  you  at  the  point  within  the  job  where  it  was 
dropped.  Remember,  jobs  must  be  recovered  within  30 
min.  If  you  do  not  wish  to  recover  any  of  the  listed  jobs, 
enter  GO  to  continue  the  job  (new  JSN)  that  you  have  just 
begun. 

Logging  Off  of  a  Cyber  Computer 

Log  off  by  typing  BYE  when  you  have  completed  a 
terminal  session. 
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File  Information 

A  file  is  a  named  collection  of  information,  such  as  a 
program  or  data.  A  filename  can  be  from  1  to  7  alphabetic 
or  numeric  characters  in  length.  All  files  used  with 
PHABSIM  and  TSLIB  must  begin  with  an  alphabetical 
character. 

There  are  four  major  types  of  files: 

Local  Files,  Local  files  are  files  created  for  the  duration 
of  a  terminal  session.  They  are  lost  when  logging-off  of 
the  computer  if  they  are  not  stored  as  a  Permanent  file 
using  the  SAVE  or  REPLACE  command.  ALL  file  ma¬ 
nipulations  MUST  be  done  in  local  file  space.  The  only 
exceptions  for  this  rule  are  the  CHANGE  and  PURGE 
commands. 

Permanent  Files,  Permanent  files  are  files  that  are  saved 
from  session  to  session. 


System  Files,  System  files  are  files,  created  by  the  com¬ 
puter  system,  that  are  used  for  internal  purposes. 

Procedure  Files,  Procedure  files  are  special  files  con¬ 
taining  executable  procedural  information.  The  entire 
Aquatic  Systems  Branch  repertoire  of  programs  and  mod¬ 
els  can  be  accessed  with  developed  procedure  files.  The 
PHABSIM  procedure  files  are  stored  in  PHABPRC  and 
the  TSLIB  procedure  files  are  stored  in  TSPROC. 

NOS  System  Commands 

The  CDC  Cyber  computer  utilizes  the  network  operating 
system  (NOS).  Following  is  a  list  of  commonly  used  NOS 
commands.  Refer  to  the  NOS  Version  1  Reference  Manual, 
published  by  Control  Data  Corporation,  for  additional 
information. 

Ifh  =  local  filename 

pfn  =  permanent  filename 


BAT — Puts  terminal  in  the  BATCH  subsystem.  Prompt  is  7^* 
CATLIST — Lists  permanent  filenames. 

CATLIST,  FN=MY****** — Lists  permanent  files  beginning  with  “MY”. 


CATLIST,  LO=F,  FN=pfti — Lists  detailed  information  on  file  pfn. 

CHANGE,  newpfn=*oldpfti — Renames  a  permanent  file. 

CLEAR — Deletes  all  local  files, 

COPY,lfti — Lists  a  local  file  on  the  terminal. 

COPYSBF,  lfnl,lfh2 — Copies  Ifhl  into  lfn2  with  a  space  in  column  1, 

DAYFILE,lfii — Dumps  dayfile  to  file  Ifti  (see  following  Note®). 

GET,pfh — Makes  a  copy  of  an  indirect  access  permanent  file  in  local  file  space. 
GET,pfti/UN=SAS6SWT —  Gets  a  file  from  another  user’s  permanent  file  space. 

PURGE, pfh — Deletes  a  permanent  file. 

RENAME,  newlfh^oldlfti — Renames  a  local  file. 

RETURN,lfh — Deletes  a  local  file. 

REPLACE, Ifn —  Replaces  the  permanent  file  with  the  same  name  as  Ifn  with  the  local  file 
Ifn. 

ROUTE,  lfn,DC=LP,ID=0 — Prints  Ifh  at  the  central  site  with  “myname” 

UJN=myname —  (7  letters)  in  the  banner. 

RWF —  Rewind  all  local  files.  Errors  often  result  from  programs  attemping  to 
read  files  that  have  not  been  rewound. 

SAVE,lfii — Makes  a  permanent  copy  of  the  local  file  Ifn. 

STATUS,F — Lists  local  filenames. 


“  The  dayfile  contains  a  sununary  of  all  control  statements,  information,  and  error  messages.  Typing  T)AYFILE,lfn**  will  cause  the  DAYFILE  to  be 
dumped  to  the  specified  local  filename,  where  it  can  be  reviewed  with  an  editor. 
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XEDIT  Commands 

XEDir  is  a  line-editor  used  to  create,  modify,  or  merge  text  files.  The  following  information  is  helpful  when  working 
with  XEDIT.  Refer  to  the  XEDIT  Reference  Manual  for  more  information. 


?? — Prompt  to  enter  a  command. 

? — Prompt  to  enter  data. 

Delimiter —  Character  used  to  separate  parts  of  an  XEDIT  command.  For  example,  in 
the  commaiKl  CS/SANKE/SNAKE/,  the  7**  is  the  delimiter.  It  is  best 
to  use  special  characters  (such  as  “;  /  @  7  as  delimeters  so  they  can  be 
distinguished  from  text  material. 

Pointer — Line  in  the  file  at  which  the  computer  is  currently  “looking.’’  All  com¬ 
mands  operate  on  the  current  line  or  subsequent  lines.  When  the  pointer 
reaches  tihe  end  of  a  file,  it  is  set  back  to  the  top  of  the  file.  If  you  are 
unsure  where  the  pointer  is  positioned,  print  one  line. 

XEDIT, Uh— Edit  a  local  file  called  Ifn. 

ABORT  [or  Stop] —  Exit  XEDIT  without  updating  the  file  (on  some  computers,  user  must 
type  STOP  rather  than  abort). 

ADD  [A]  — Add  a  string  to  the  end  of  the  current  line  (the  system  responds  with  a 
“?’’  prompt;  type  the  data  to  be  added). 

BOTTOM  [B] — Move  pointer  to  bottom  of  the  file. 

CHANGE  [C;strmgl;string2;!] — Find  first  line  containing  stringl;  change  all  occurrences  of  stringl  to 

string2  within  that  line. 

CHANGE  STRING  [CS;stringl;^ring2;!] — Change  first  occurrence  of  stringl  to  string2. 

COPY  Ifn  n —  Copy  n  lines  from  the  file  being  edited  to  a  file  named  Ifn. 

-CR-  —  Carriage  return;  it  works  as 

1.  Bitry  terminator  (normal  end  of  line), 

2.  Enter  input  mode  to  insert  any  number  of  lines, 

3.  Terminate  input  mode. 

DELETE  [D] — Delete  current  line. 

[D3] — Delete  3  lines  starting  at  current  line. 

END — End  editing,  updated  file  is  a  local  file. 

INSERT  [I] — Insert  line  after  the  current  line  (prompt  is  “?“). 

[16] — Insert  6  lines  after  the  current  line. 

LOCATE  [L;string;] — Locate  the  first  occurrence  of  string. 

[L;button;*] — Locate  all  occurrences  of  “button”  from  current  position  to  end  of  file. 

MODIFY  [M] — Modify  the  current  line  (the  line  is  printed;  space  the  cursor  to  the 
change  point  and  replace  characters  as  needed,  replaces  with  a 
space,  “#”  deletes  a  character  and  closes  the  space). 

NEXT  [N] —  Move  the  pointer  to  the  next  line  down. 

[N4] — Move  the  pointer  4  lines  down. 

PRINT  [P] — Print  the  current  line. 

[P5] —  Print  5  lines  and  moves  pointer  to  fifth  line. 

READ  Ifn — Read  a  file  Ifn  into  the  edit  file  below  the  current  line. 


TOP  [T] — Move  the  pointer  to  the  top  of  the  file. 
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TOPNULL  [TN] — Move  the  pointer  to  the  top  of  the  file  and  insert  a  blank  line  as  the  first 
line  of  the  file. 

WHERE  [W] — Print  the  current  line  number. 

X  (prefix) —  Suppress  verification,  as  in  XCS;  strl;str2;  (changes  string  without  print¬ 
ing  changed  line). 

/  (prefix) —  Advance  pointer  1  line  before  executing  the  command. 

(prefix) — Go  to  the  top  of  the  file  before  executing  the  command. 

*  (suffix) — Repeat  the  command  for  all  occurrences  from  pointer  position  to  the  bot¬ 
tom  of  the  file,  as  in  P*  (prints  all  lines  of  a  file  from  the  current  line  to 
the  bottom  of  the  file). 

. — Advance  the  pointer  1  line  and  then  repeat  the  previous  command. 
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Appendix  E  Time  Series  User  Interface 


Introduction 

The  Time  Series  Library  user  interface  (RTSM)  is  a 
hierarchical  menu-based  system  structured  to  follow  the 
organization  in  this  manual.  The  system  is  designed  to 
provide  an  integrated  working  environment  in  which  the 
user  has  a  brief  tm-line  description  of  each  active  menu 
function  as  well  as  access  to  more  detailed  help.  A  dia¬ 
logue  box  is  provided,  where  each  program’s  default  input 
and  output  filenames  can  be  changed.  In  addition,  several 
useful  file  management  functions  are  provided.  Those 
users  familiar  with  the  PHABSIM  user  interface  (RPM) 
will  have  no  difficulty  getting  started  with  RTSM. 

Installing  the  Time  Series  User 
Interface 

This  text  explains  how  to  prepare  a  system  to  use  the 
RTSM  user  interface  for  the  TSLIB  programs. 

First,  refer  to  Appendix  D  for  the  appropriate  method  to 
install  TSLIB  c«i  your  hard  disk.  In  particular,  the  BOS 
path  must  be  set  properly  to  proceed  with  the  installation. 
In  addition,  the  DOS  mode  command  must  be  accessible 
through  your  path. 


The  following  programs  must  be  in  the  same  directory 
as  the  other  TSLIB  programs  for  the  TSLIB  user  interface 
to  work*: 

PM.COM,  PMINSTAL.EXE,  TSBAT.DAT, 

TSHELP.HLP,  RTSM.BAT,  TSLONG.FIL, 

TSSHORT.FIL,  TSLOGO.EXE 

Change  to  your  data  directory  and  start  the  interface  by 
typing  RTSM  and  pressing  ENTER  at  the  DOS  prompt. 
If  this  is  the  first  time  RTSM  has  been  used,  the  installa¬ 
tion  program  will  be  invoked  and  allow  you  to  change  a 
set  of  five  selections  to  create  a  special  file  called 
TSDERDEF.  If  you  wish  to  change  the  set-up  of  your 
user  interface  at  any  time,  you  may  reinstall  by  typing 
PMINSTAL  TS^  at  the  DOS  prompt.  It  would  be  a  good 
idea  to  review  the  selections  before  the  installation  is 
performed.  An  example  of  the  installation  screen  is 
shown  in  Fig.  El;  an  explanation  of  each  selection  fol¬ 
lows. 

1.  COLOR: 

If  your  computer  has  a  color  monitor,  press  the  down 
arrow  to  go  to  the  next  selection;  otherwise,  press  the 
space  bar  for  a  monochrome  monitor. 

2.  EDITOR: 

Type  the  name  of  the  ASCII  text  editor  (e.g.,  WED, 
PE,  TED)  you  wish  the  user  interface  program  to  use. 
The  DOS  editor  EDLIN  is  the  default  editor,  but  we 


I  COLOR 
EDITOR 
LIST 
MENUS 
PATH 


Install  for  TS 
:  YES 
;  Edlin 
;  MQre< 

:  LONG 
:  C:\TS 


Help 

UP  &  arrow  keys  to  move 

SPACE  color  or  MBmS  • 

FIO  to  install  the  interface 


TO 


just  begin  by  typing  from  the' keyboard 
REl®feN''=tbJiaccept  the  text 


gaccept 

the  text 


FIO  Install.. 


Fig.El,  Initial  menu  for  the  FSLIB  user  interface. 


®  Note  that  the  fwograms  PM  and  PMINSTAL  are  the  same  for  both  TSLIB  and  PHABSIM. 
If  you  wish  to  reinstall  PHABISM,  type  PMENSTALL  PM. 
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do  not  recommend  its  use.  Type  the  name  of  the  editor 
you  have  installed  on  your  system  followed  by  enter. 
(Your  editor  must  be  accessible  through  the  DOS 
path.) 

3.  LIST: 

Type  the  name  of  your  browse  utility  (e.g.,  LIST, 
BROWSE)  that  you  wish  the  user  interface  program 
to  use.  The  DOS  command  MORE<  is  the  default 
listing  program,  but  we  do  not  recommend  its  use. 
Type  the  name  of  the  lister  you  have  installed  on  your 
system  followed  by  enter.  (Your  lister  must  be  acces¬ 
sible  through  the  DOS  path.) 

4.  MENUS: 

For  KTSM,  there  is  no  distinction  between  long  and 
short  menus.  This  selection  has  been  maintained  for 
compatibility  with  PHABSIM,  for  which  the  short 
menus  are  used  in  the  teaching  courses,  and  contain 
the  programs  covered  in  those  courses  as  well  as  other 
commonly  used  programs.  The  long  menus  contain 
all  programs  in  the  PHABSIM  system.  For  KTSM, 
press  the  down  arrow  to  the  next  selection. 

5.  PATH: 

Type  the  drive  and  full  pathname  (e.g.,  C:\TSLIB) 
where  the  TSLIB  programs  have  been  placed.  You 
must  type  this  correctly;  otherwise,  the  user  interface 
program  will  not  know  where  to  find  the  TSLIB 
programs. 

6.  FIO: 

When  all  selections  have  been  made,  pressing  the  FIO 
key  will  complete  the  installation  process.  A  file 
named  TSDEF.DEP  will  appear  in  your  default  direc¬ 


tory.  This  file  contains  the  answers  to  the  selections 
you  have  made. 

General  Program  Usage  and  Control 

To  Start  the  TSIJB  user  interface,  type  RTSM  at  the  DOS 
command  line  in  your  data  directory  (or  from  wherever  the 
PMINSTAL  program  was  run),  followed  by  Enter. 

The  initial  hierarchial  menu  structure  will  appear  on  the 
screen,  looking  similar  to  Fig.  F.2.  Movement  within  or 
between  menus  is  accomplished  with  arrow  keys.  Enter  or 
a  carriage  return  will  select  the  menu  option  when  that 
particular  option  is  highlighted.  Tlie  next  level  of  the  inter¬ 
face  hierarchy  is  shown  for  each  highlighted  function. 

Additional  program  options  assigned  to  specific  function 
keys  (as  indicated  at  the  bottom  of  Fig.  F.2)  can  be  selected 
by  pressing  the  desired  function  key.  Only  functions  appro¬ 
priate  for  the  existing  menu  choice  are  displayed.  The  Esc 
key  is  used  to  back  up  (return  to  previous  menus)  through 
the  hierarchical  structure  of  the  menus  or  to  quit  the  program. 
A  listing  of  the  entire  menu  structure  can  be  foimd  in  Table 
F.2. 

Using  the  RTSM  Interface 

You  can  move  through  the  available  options  within  each 
menu  by  using  the  up  or  down  arrow  keys.  The  highlighted 
menu  option  can  be  selected  by  either  pressing  Enter  or 
using  the  right  arrow  key.  Note  that  at  the  top  of  the  page,  a 
1-line  description  of  the  highlighted  menu  option  is  dis¬ 
played.  Figure  F.3  provides  an  example  of  the  screen  where 


Description 

Obtain  and  Prepare  fIow  Time  Series  Data 


HYDROLOGY 

Acquisition 

HABITAT/FLOW 

Entry 

DAILY  HABITATS 

Manipulation 

MONTHLY  HABITATS 

Listing 

ANNUAL  HABITATS 

•:  Tr  ans  f  o  r  ma  t  i  ons 

..I 

Water  Systems 

FI ‘HELP 


F4 - CHART 


F7 -TODAY . F8-.DIR  .  F9-DOS. 


Fig.  F.2,  Initial  hierarchical  menu  for  the  TSLIB  user  interface. 


^  If  installing  PHABSIM,  the  file  will  be  named  PMDEF.DEF. 
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Description 

calculates  several  statistics  fox  monthly  time  series  data  files 


nYmohcm 

HASltAi’/FLOV^ 
DAILY  HABITATS 
;i MONTHLY  HABITATS  i: 
AHiltJAL  HABITATS 


File  Creation 
Generation 
:  Analysis 
Manipulation 
Pi splay _ 


[;:SCORTS 
5  LFTDPR 


F4 -  CHART 


F7- TODAY  F8-DIR  F9-DOS 


Fig.  F3.  Screen  showing  hierarchiacal  structure  of  the  menu  system. 


MONTHLY  HABITATS,  Analysis,  and  the  program 
SCORTS  have  beai  selected.  You  can  obtain  additional 
help  on  any  selected  menu  item  by  using  the  FI  key  while 
on  that  opticMi,  as  shown  in  Fig.  F.4. 

If  you  desire  to  run  a  particular  program,  such  as  the 
SCORTS  program  shown  selected  in  Fig.  F.3,  Enter  will 
display  a  dialogue  box  containing  the  default  input  and 
output  filenames  used  by  convention  in  Instream  Flow 
Information  Paper  27,  The  system  also  displays  additional 


information  about  the  selected  program  to  aid  you  as 
shown  in  Fig.  F.5. 

You  may  change  any  of  the  filenames  by  using  the  arrow 
keys  to  highlight  the  appropriate  file,  then  typing  a  new 
complete  name  from  the  keyboard.  The  system  will  auto¬ 
matically  substitute  the  revised  filename(s)  in  all  other 
program  dialogue  boxes  that  used  the  original  filename.^* 
This  automatically  preserves  the  linkage  between  program 
units  that  utilize  common  default  filenames. 


Pescription 

Calculates  several  statistics  for  monthly  time  series  data  files 


HYDROLOGY 
HABITAT/FLOW 
DAILY  HABITATS 
MONTHLY  HABITATS 
ANNUAL  HABITATS 


File  Creation 

Generation 

Analysis 

Manipulation 

Display 


■SCORTS 

LPTDUR 


Read  monthly  time  series  file  and  calculate  several  statistical 
parameters  including  log  normal  distribution,  and  lag  one  corre¬ 
lation  coefficients. 

Syntax:  ESCORTS  ZMTS  ZOUT  ZANTS 

2MTS  “  monthly  time  series  file  in  USGS  or  NWPC  format;  can 
be  multi -record  (input) 

ZOUT  ~  SCORTS  results  (output) 

ZANTS  =  average  of  IZ  monthly  values  for  each  year  (output) 


Fig  F.4.  Example  of  help  screen  displayed  by  using  the  FI  key. 


^  Note  that  an  exception  to  this  nile  is  any  filename  that  begins  with  the  letters  ZOUT. 


Time  Series  User  Interface 


Desciiptioti 

CaXculatea  geveyai  ■st^t;istica  for 


iliiilii® 

Road  monthly  time  oeties  file  and  calculate  aevetal  statistical 
parameters  including  log  normal  distribution,  and  lag  one  corre¬ 
lation  coefficients* 

Syntax  j  RSCORTS  2;NTS  &OUT  ZANTS 

2MTS  ~  monthly  time  series  file  in  USdS  or  NWDC  format;  can 
be  multi -record  (input) 

ZOUT  “SCORTS  results  (output) 

2ANTS  ^  average  of  12  monthly  values  for  each  year  (output) 


Dialog  Box 
Output  Output 
ZOUT  2ANTS 


CURRENT  DIRECTORY t  C;\TSLIB 
Insert 


^  F2-LIST  F3-EDIT  F4-CHART  F5-PRINT  F7-TODAY  F8-DIR  F9-DOS  FIO-F 

Fig.  ¥S,  Example  of  dialogue  box  and  program  description. 


A  filename  may  also  be  changed  in  the  dialogue  box 
by  moving  the  cursor  to  the  desired  position  and  pressing 
the  F8  function  key.  This  will  allow  you  to  specify  a  file 
specification  (the  default  is  *.*),  as  shown  in  Fig.  F.6; 
then,  the  system  will  display  any  matching  filenames  in 
a  window  as  indicated  in  Fig.  F.7.  You  can  then  cursor 
down  or  up  to  the  desired  file  and  press  Enter,  which 
will  automatically  substitute  this  file  in  the  highlighted 


position  of  the  dialogue  box.  The  F7  (TODAY)  function 
will  also  allow  this  file  name  substitution. 

Once  you  are  satisfied  that  the  appropriate  files  have  been 
selected  for  iiy)ut  and  output,  the  program  can  be  invoked 
by  pressing  the  FIO  function  key.  No  action  will  be  taken 
unless  this  key  is  pressed.  To  exit  the  dialogue  box  without 
running  the  program,  press  the  Esc  key. 


Enter  File  Spect*.* 


HYBROLCX3Y 
HABITAT/FLOW 
DAILY  HABITATS 
; MONTHLY  HABITATS;;: 
ANNUAL  HABITATS 


File  Creation 

Generation 

Analysis 

Manipulation 

Display 


SCORTS 

LPTDUR 


F2-LIST  F3-EDIT  F4- CHART  F5- PRINT 


Fig.  F.6.  Example  of  using  the  F8  function  key  to  display  a  directory. 
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The  RTSM  program  runs  the  TSUB  programs  by  insert¬ 
ing  R  in  fixmt  of  the  program  name  displayed  on  the  screen. 
If  for  any  reason  RTSM  cannot  find  the  program  you  have 
asked  to  be  run,  a  message  will  be  displayed.  If  this  occurs, 
check  to  be  sure  you  have  copied  all  TSLIB  distribution 
disks  and  set  your  path  properly. 

The  user  interface  may  be  exited  by  repeatedly  pressing 
the  Escape  key  and  answering  Yes  to  the  exit  prompt. 
Following  this  prompt,  you  will  be  asked  if  you  wish  to  save 
the  current  filenames.  Answering  Yes  to  this  prompt  will 


retain  your  default  filenames  for  the  next  time  RTSM  is  run. 
Answering  No  will  result  in  the  original  TSUB  default 
filenames  the  next  time  RTSM  is  run. 

Editing  Filenames  in  the  Dialogue  Box 


Pressing  the  Enter  key  will  move  from  one  filename  to 
the  next  in  the  dialogue  box.  Editing  the  filenames  may  be 
accomplished  in  two  distinct  modes:  insert  and  typeover. 


Table  F.l.  Dialogue  box  editing  Junctions. 


Key 

Action 

Key 

Action 

Foward  one  character 

Backward  one  character 

Enter  (4-*) 

Forward  one  field 

Ctrl^J 

Back  one  field 

Tab(i) 

Poation  on  first  character 

Tab(l-) 

Position  on  first  character 

Ctrl”^ 

Position  on  first  character 

Ctrl- 

Position  on  first  character 

Delete 

Remove  character  under  cursor 

Backspace 

Remove  character  before  cursor 

Esc 

Leave  dialog  box  without  saving  filenames 

Insert 

Switch  modes  (insert  is  initial  default) 

Key 

Insert  mode  action 

Typeover  mode  action 

Home 

Beginning  of  field 

Beginning  of  first  field 

End 

End  of  field 

End  of  last  field 

Valid  letter  on 

Erase  name  and  begin  a  new  name 

Replace  character  under  cursor 

first  character 

Valid  letter  on 

Insert  letter  in  name  at  cursor 

Replace  character  under  cursor 

any  other  character 
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These  modes  work  much  like  those  in  other  popular  mi¬ 
crocomputer  programs  and  will  facilitate  either  total  name 
replacement  or  minor  editing.  Some  users  may  prefer  one 
mode  to  the  other — however,  the  proficient  user  will  find 
it  useful  to  switch  back  and  forth  as  the  need  dictates. 

The  functions  supported  are  listed  in  Table  F.  1 .  Pressing 
the  Insert  key  toggles  between  insert  and  typeover  modes. 
The  mode  is  indicated  near  the  bottom  of  the  dialogue  box 
as  shown  in  Fig.  F.5. 

Note  that  as  filenames  are  accepted,  they  will  appear  in 
uppercase  characters.  Specifying  input  files  not  found  in 
the  current  directory  will  result  in  an  informative  message. 

Use  of  Function  Keys 

The  function  keys  indicated  at  the  bottom  of  each  screen 
can  be  used  at  any  time.  The  system  will  take  no  action  if 
the  selected  function  is  not  appropriate  for  the  selected 
menu  option.  The  particular  use  of  each  function  key  is  as 
follows: 

FI — ^Help: 

The  FI  key  will  display  a  window  containing  additional 
help  for  the  presently  selected  menu  option.  The  Esc  key 
will  return  the  user  to  the  currently  active  menu  choice. 

F2— List: 

The  F2  key  is  active  from  within  the  directory  window 
obtained  from  use  of  the  F7  or  F8  key  or  within  the 
dialogue  box.  F2  will  show  the  contents  of  the  selected  file 
in  the  directory  window.  The  particular  list  utility  for  your 
system  is  specified  during  the  initial  system  setup  and  is 
the  DOS  MORE<  command  by  default 

F3— Edit: 

The  F3  key  allows  access  to  the  editor  that  the  user 
specified  during  the  initial  system  set-up.  The  default 
editor  is  the  DOS  EDLIN  utility. 

F4 — Chart: 

The  F4  key  places  the  user  into  the  TSLIB  on-line  help 
utility  (RHELP).  This  function  for  TSLIB  is  not  currently 
available. 

F5— Print: 

The  F5  key  allows  the  user  to  print  the  highlighted 
filename  from  within  the  directory  window  or  dialogue 
box.  The  file’s  name,  creation  date  and  time,  and  current 
date  and  time,  with  an  optional  user-entered  file  descrip¬ 
tion,  will  appear  at  the  top  of  the  page,  followed  by  the  file 


contents.  Note  that  only  ASCII  files  can  be  printed  with 
confidence;  printing  non-ASCII  files  may  cause  xmpre- 
dictable  results. 

F7 — ^Today: 

The  F7  key  allows  the  user  to  obtain  a  directory  window 
showing  all  files  created  today  (i.e.,  the  DOS  dates  that 
match  the  computer’s  clock  date).  See  the  F8  key’s  de¬ 
scription  for  capabilities  available  once  the  directory  win¬ 
dow  is  displayed. 

F8— DIR: 

The  F8  key  allows  the  user  to  obtain  a  directory  window 
with  all  files  matching  the  file  specification.  The  user  can 
scan  the  list  by  scrolling  through  the  window  with  the  up 
or  down  arrow  keys.  If  the  dialogue  box  is  active  at  the 
time  F8  is  used.  Enter  can  be  used  to  move  the  selected 
filename  in  the  directory  window  to  the  selected  position 
within  the  dialogue  box. 

Pressing  F2  while  the  cursor  is  in  the  directory  window 
will  display  the  selected  file  with  the  user-specified  list 
utility.  Similarly,  pressing  F3  will  allow  easy  file  editing. 

In  addition,  the  common  file  functions  copy,  rename, 
and  delete  are  available  in  the  directory  box.  You  will  have 
no  trouble  with  these  functions. 

F9_DOS: 

The  F9  key  will  allow  the  user  to  go  to  the  DOS  com¬ 
mand  Une.  This  is  handy  for  file  management  and  other 
functions.  The  user  returns  to  the  user  interface  when 
finished  by  typing  EXIT  at  the  DOS  prompt.  This  will  be 
signified  by  “Enter  ‘EXIT’  to  return  to  interface’’,  dis¬ 
played  above  the  DOS  prompt.  You  must  type  EXIT  and 
press  Enter  to  return  to  the  user  interface  program.  Do  not 
try  to  return  to  RTSM  or  RPM  by  typing  their  names — this 
would  only  load  another  copy  of  the  menu  program  into 
memory.  While  in  DOS,  do  not  use  the  CHKDSK/F  or 
install  other  memory  resident  programs  such  as  PRINT. 
Using  RENAME  or  DELETE  may  cause  problems  if  you 
have  pressed  F9  while  inside  the  directory  window  of  the 
user  interface.  Finally,  pressing  F9  will  create  a  local  file 
called  PMSHELL.BAT. 

FIO — ^Run: 

The  FIO  key  is  used  to  invoke  a  specific  program  from 
the  dialogue  box.  This  is  the  only  window  in  which  this 
key  is  active. 

Note:  Function  Key  6  is  reserved  for  future  use. 
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Table  E2.  Hierarchical  menu  structure  of  the  time  series  user  interface 


HYDROLOGY — Obtain  and  prej^re  flow  time  series  data  for  analysis 

Acquisition — Assist  in  WATSTORE  preprocessing 

MESS — Generates  a  WATSTORE  message  request  file 
GETREL — Generates  a  WATSTORE  tape  reel  numbers  file 
DAILY — Generates  a  WATSTORE  mean  daily  streamflow  request  file 
DURTBL — Generates  a  WATSTORE  duration  table  request  file 
INVENT — Generates  a  WATSTORE  station  inventory  request  file 
PEAK — Generates  a  WATSTORE  peak  streamflow  values  request  file 

Entry — you  must  enter  data  by  hand,  this  is  the  place 

QIN — Creates  daily  or  monthly  streamflow  data  file 
CHGFMT — Changes  a  monthly  USGS  format  to  NWDC  or  vice  versa 

Manipulation — Modify  daily  time  series  data  files 

DQFY — Removes  incomplete  years  from  a  WATSTORE  daily  streamflow  file 
DQTOMQ — Creates  a  monthly  streamflow  file  from  a  daily  streamflow  file 
PAGEBR — Prepares  a  WATSTORE  output  file  for  formatted  listing 
SELDUR — Reduces  a  WATSTORE  duration  analysis  file 

Listing — Organize  daily  time  series  data  for  orderly  printing 

CEDUR — Reports  6  sets  of  statistics  for  a  daily  streamflow  data  file 

LSTDQ — Segregates  a  WATSTORE  daily  streamflow  file  by  header  or  water  year 

Transformations — Tansfers  streamflow  from  one  geographic  site  to  another 
TRANMN — Tfansfers  mcmthly  streamflow  using  equation 
Qnew  =  A*(Qold)**B 

TRANMR — Tiansfers  mcMithly  streamflow  with  3  options 
TRANTS — Tiansfers  annual  streamflow  from  long  to  short  record  site 

Water  systems — ^Analysis  of  flow  manipulation  systems 
QABSDY — Subtracts  a  diversion  flow  by  day  from  a  daily  flow  file 
QABSMN — Subtracts  a  diversion  flow  by  month  from  a  monthly  flow  file 
RESYLD — Operates  a  single  reservoir  with  monthly  flows 
RESIN — Creates  an  input  file  for  the  RESYLD  program 
CHGMIN — Changes  minimum  flow  values  in  a  RESYLD  input  file 
RESYl — Computes  the  yield  index  for  a  reservoir 
RSTOMQ — Creates  a  monthly  flow  file  from  the  ZRES  output  file  from  RESYLD 

HABITAT-FLOW — ^Prepare  habitat  area-versus-flow  function  for  analysis 
Entry — Enter  habitat  area-versus-streamflow  function  data 
CRHAQF — Creates  a  habitat  area-versus-streamflow  file 

Manipulation — ^Modify  habitat-versus-streamflow  functions 
COMHQF — Sums  or  combines  2  ZHAQF  files  with  user-supplied  weights 
HAQINT — Estimates  habitat  area  from  a  ZHAQF  file  by  interpolation 
MRGHQF — Selectively  extract  life  stages  from  1  or  2  ZHAQF  files 
MULHQF — Scales  life  stages  habitat  areas  in  a  ZHAQF  file 
NRMHQF — Normalizes  habitat  values  in  a  2nAQF  file  to  a  specified  flow 
SUMHQF — Sums  ccmditional  cover  columns  in  a  ZHAQF  file  to  a  single  life  stage 

Listing — Organize  habitat-versus-streamflow  functiems  for  orderly  printing 
HABOUT — Sorts  2nAQF  file  by  monthly  flows  and  calculates  adult  equivalent  habitat 
HBOUTA — Formats  ZHAQF  data  file  for  printing 
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Table  E2.  Continued 


Display — Plot  graphs  of  habitat-versus-streamflow  functions 
LPTHQF — Plots  a  ZHAQF  data  file  one  species  per  page 

DAILY  HABITATS — Calculate-analyze  habitat  values  based  on  daily  flows 
Generation — Calculate  habitat  values  based  on  daily  flows 

HABTD — Calculates  daily  habitat  time  series  then  converts  to  monthly  series 

Analysis — Calculate  daily  streamflow  statistics 

DQDUR — Calculates  exceedence  probabilities  from  WATSTORE  duration  file 

MONTHLY  HABITATS — Calculate-analyze  habitat  values  based  on  monthly  flows 
File  creation — ^Assist  in  file  preparation  for  HABNET 
HABINN--Creates  a  HABNET  options  file 
HQFMON— Creates  a  HABNET  ZHAQFM-type  file 

QTEM — Creates  a  HABNET  temperature-versus-flow  equation  file 

Generation — Calculate  monthly  habitat  time  series 

HABTS — Calculates  monthly  habitat  time  series  for  multiple  species-life  stages 
HABNET — Networkwide  monthly  (temperature-conditioned)  habitat  time  series 

Analysis — Calculate  monthly  time  series  statistics 
SCORTS — Calculates  several  statistics  for  monthly  time  series  data  files 
LPTDUR — Calculates  exceedence  statistics  for  1  or  2  monthly  time  series  files 

Manipulation— Modify  monthly  time  series  data  with  algebraic  functions 
CHGFMT — Changes  a  monthly  USGS  format  to  NWDC  or  vice  versa 
COMMTS — Calculates  a  weighted  sum  of  2  USGS  monthly  data  files 
MULMTS — Multiplies  a  monthly  time  series  data  file  by  a  constant 
SELMTS — Selective  extraction  of  months  from  2  or  more  monthly  data  files 
GETl — Extracts  records  from  a  multirecord  file 

Display — Plot  graphs  of  monthly  time  series  data 

LPTQHA — Plots  1  or  2  monthly  time  series  file,  approximately  5  years  per  page 
LPTTSN — Plots  up  to  5  monthly  time  series  files 

Listing — Organize  monthly  time  series  data  for  orderly  printing 
MTSLST — Formats  a  monthly  time  series  data  files  (to  LOTUS  1-2-3) 

ANNUAL  HABITATS —  Calculate-analyze  habitat  values  based  on  armual  events 

File  creation — Prepare  data  files  for  armual  habitat  time  series  analysis 
EFFIN— Creates  input  file  for  EFFHAB 
EFFIN2 — Creates  input  file  for  EFFHB2 

Generation — Calculate  armual  habitat  time  series 

ANNTS — Calculates  an  armual  habitat  time  series  from  monthly  data 
ANEQTS — Calculates  annual  equivalent  adult  habitat  time  series 
EFFBIAB — Calculates  an  effective  adult  habitat  time  series  for  four  life  stages 
EFFHB2 — Calculates  an  effective  adult  habitat  time  series  for  odd  life  cycles 

Analysis — Calculate  exceedence  statistics  for  armual  time  series 
LPTDAN — Calculates  exceedence  statistics  for  armual  time  series 

Display — Plot  graphs  of  armual  exceedence  values 
LPTDAN — Calculates  exceedence  statistics  for  armual  time  series 
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Appendix  G.  Running  WATSTORE  on  the  USGS 
_ Amdahl  Mainframe  Computer 


To  access  WATSTORE,  users  must  have  a  valid  account 
on  the  USGS  Amdahl  mainframe  computer  in  Reston, 
Virginia.  Such  accounts  can  be  opened  by  contacting 

NAWDEX  Chief  of  User  Services 
U.S.  Geological  Survey 
421  National  Center 
Reston,  VA  22092 
(703)  648-5664  or  FTS  959-5664 

Users  manuals  will  be  provided  by  the  U.S.  Geological 
Survey. 

The  DAILY,  DURTBL,  INVENT,  MESS,  and  PEAK 
programs  have  been  developed  to  provide  users  with  a 
method  for  retrieving  information  from  WATSTORE. 
These  programs  interactively  prompt  the  user  with  a  series 
of  questions  pertaining  to  the  type  of  data  desired.  After 
the  questions  are  completed,  an  output  file  is  produced  in 
the  form  of  a  WATSTORE  request  job.  This  file  is  trans¬ 
ferred  to  the  USGS  Amdahl  mainframe  computer  using  a 
communications  software  package  and  is  submitted  for 
execution  on  the  Amdahl.  Users  are  responsible  for  obtain¬ 
ing  their  own  communications  software  package. 


Step  2:  Logging  On  to  the  USGS  Amdahl  Computer 


The  following  telephone  numbers  are  used  to  dial  the 
Amdahl  computer: 

FTS— 1200  baud— 8,959,4100 
FTS— 300  baud— 8,959,7800 
Commercial — 1200  baud — 1,703,648,4100 
Commercial — 300  baud — 1,703,648,7800 


CONNECT 


When  CONNECT  appears  on  the  screen,  you  have  suc¬ 
cessfully  logged  on  to  the  Amdahl  computer.  Enter  a 
carriage  return  to  continue.  Note:  For  this  documentation, 
user  responses  will  be  bold  and  underlined. 

(carriage  return) 


CRLt, DISPLAY,  OR  MODIFY? 


c 


iENTER;  NUMBER? 


AMDAX 


Step  1:  Set  the  Communications  Parameters  for  the 
Amdahl  Computer 


BAUD: 
PARITY: 
WORD  BITS: 
STOP  BITS: 

ECHO: 
MESSAGES: 
PACE  OR  PAUSE: 


300-2400 

MARK 

7 

1 

YES 

NO 

.5  S  FOR  UPLOADING  FILES 


Note:  If  you  see  colons  at  the  beginning  of  each  line  on 
the  WYLBUR  system,  you  may  remove  the 
colons  with  a  “Strip  characters”  function  (if  the 
communications  software  you  are  using  offers 
such  a  function). 


CALLING  [a  nutftbet  wiil 


be  . displayed  here5 


Do  not  worry  if  the  response  is  slow  or  garbled. 
There  will  be  a  several  second  delay,  and  then  the 
message: 


call  CCMPLETE 


Enter  a  carriage  return. 
(carriage  return) 


j  Note:  If  you  cannot  connect  to  the  computer  immedi¬ 
ately,  try  again.  It  may  take  several  ttys.  If  you 
do  get  on  but  become  disconnected,  use  the 
RECONN  command  to  get  back  on.  You  will  be 
returned  to  the  same  place  you  were  when  you 
were  disconnected.  To  use  RECONN,  type  RE¬ 
CONN  immediately  after  your  log-on  ID  (on  the 
same  line). 
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USS327X  aSGS  5030  CROSS  DOMAIN  SERVICES 

RLEASB  ENTER  '^$0^',  'M204A^^  ^M204B",  "WYLRtJR^ 

DR  _ 

The  above  message  will  appear.  In  this  documentation, 
you  will  be  logging  on  to  TSO  to  upload  your  request  files 
and  to  submit  them  for  processing.  You  will  then  log  on  to 
WYLBUR  to  retrieve  your  output. 

Step  3:  Logging  on  to  TSO  and  Uploading  Files  to  the 
Amdahl  Computer 

TSO 

Here,  you  will  be  asked  for  your  log-on  ID  and  your 
password,  as  assigned  by  the  person  who  initiated  your 
account. 

'  Acre  20  oi  Acr2  4  fiNtER '  '  i'b  ^ . 

ACR82004  ENtSR  I^AgSWORB- _ 

A  series  of  lines  will  be  printed.  When  you  see  the 
following  line,  enter  a  carriage  return. 

02 i-  ACF2  ;  i  E^ER  jjQtl^RR^  V OR- ' HIT ENTER  '  TO'  CC^rriNDE ■ ;! ■ ;  ..jT :■ . 


You  have  created  a  new  file  in  which  to  place  the 
request  file.  When  the  “INPUT”  prompt  appears,  the 
computer  is  ready  to  accept  the  request  file.  Begin  the 
file  transfer  using  your  microcomputer  communications 
software  package. 

When  the  file  transfer  is  complete,  wait  several  seconds, 
then  exit  the  input  mode  by  pressing: 


(carriage  return) 


Now  you  are  in  the  edit  mode  and  the  following  message 
is  displayed: 


Check  the  file  to  verify  that  the  file  transfer  encountered 
no  errors  by  using  the  L  command.  Simply  enter  L  at  the 
edit  prompt  and  press  the  return  key.  If  errors  exist,  do  not 
save  the  file.  Exit  the  editor  and  return  to  the  step  that 
creates  a  file — the  edit  command. 

To  save  and  exit  the  request  file,  enter  the  following  two 
commands: 


SAVE 


(carriage  return) 


END 


|JGWD6SM  LOGON  IN  PROGRESS  AT  X3i01t48  ON  APRIL  4,  1990 _ 

The  next  2  lines  are  messages  that  are  listed  every  time 
you  log  on.  It  may  take  several  seconds  for  them  to 
complete.  Remember,  be  patient! 

NO  BROADCAST  MESSAGES 

DATA  SET  STARTUP. CLIST  NOT  IN  CATALOG  OR  CATALOG  CAN  NOT  BE  : . 

ACCESSED 

READY 


You  may  now  submit  the  job  for  processing  with  the 
SUBMIT  command. 

Step  4:  Submitting  a  Job  for  Processing 

SUBMIT  filename  (MYJOB.CNTL  was  filename  of  pre¬ 
vious  example) 

ENTER  JOBNAME  CHARACTER  <S )  ^  ^  '  .  ^ 


You  are  now  logged  on.  Congratulations!  When  the 
“READY”  message  is  displayed,  you  can  begin.  To  see 
which  files,  if  any,  are  present  on  the  account,  enter: 

LISTC 


This  can  be  any  letter  or  number,  but  use  a  different  one 
for  each  job  to  ensure  that  your  jobs  have  unique  names. 

After  a  character  has  been  entered,  the  computer  will 
respond  with  the  following  message: 


You  are  now  ready  to  transfer  your  request  file(s),  cre¬ 
ated  by  the  DAILY,  DURTBL,  INVENT,  MESS,  or  PEAK 
programs,  using  your  micrcomputer  communications  soft¬ 
ware  package. 

First,  create  a  file  in  which  to  transfer  the  request  file  by 
using  the  EDIT  command.  This  file  can  have  any  name  not 
already  on  the  account  but  must  end  with  “CNTL”.  To 
create  a  new  file,  substitute  the  name  of  your  choice  for 
“MYJOB”.  Include  the  words  “NEW”  and  “NONUM”  to 
specify  a  new  file  without  line  numbers. 

EDIT  MYJOB.CNTL  NEW  NONUM 


ABCD123A::<JOB04l33}  SUBMITTED. _ 

Your  job  is  now  in  queue  for  execution.  Remember  the 
job  number  (4133  here)  and  write  it  down.  To  keep  track 
of  the  job’s  progress,  use  the  “STATUS”  command. 

STATUS 

You  will  get  one  of  the  following  messages  to  inform 
you  of  the  status  of  your  job.  The  message  that  you  get  will 
depend  on  the  amount  of  data  you  requested  and  priority 
level  you  assigned  to  the  job. 

iiiVJOB  ABCD123A  ;<JOB04133)  ■  WAITING?: FOR  ^ EXECUTION,  IN  HOLD  STATUS 


INPUT 


READY 
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This  message  indicates  that  the  computer  is  waiting  to 
process  the  request  file.  You  may  want  to  wait  a  few 
minutes  and  then  check  the  status  again.  If  the  job  is  still 
in  the  hold  status,  you  may  want  to  log  off  and  then  log  on 
later  to  retrieve  your  output.  To  log  off  completely,  type 
LOGOFF  to  log  off  TSO,  and  then  type  LOGOFF  again 
to  log  off  the  Amdahl. 

When  you  redial  the  Amdahl  to  retrieve  your  output,  log 
on  to  WYLBUR  (instead  of  TSO)  and  then  follow  the 
instructions  in  Step  5  to  retrieve  output  from  the  WYL¬ 
BUR  fetch  queue. 

JOB  ABCD123A  (JOB04133>  EXECUTIIIG 

READY _ 

This  message  indicates  that  the  request  file  is  being 
processed.  You  may  want  to  stay  logged  on  for  a  few 
minutes  until  the  status  is  “on  output  queue 

JOB  ABCD123A  (JOB  04133)  ON  OUTPUT  QOEUE _ 

This  message  indicates  that  the  request  file  has  been 
processed.  Log  off  of  TSO  by  typing  LOGOFF  and  then 
log  on  to  AYYLBUR  to  retrieve  your  output.  Follow  the 
instructions  in  Step  4  to  retrieve  output  from  the  WYL¬ 
BUR  fetch  queue. 


Step  5:  Output  Retrieval  from  the  WYLBUR  Fetch 
Queue 

When  logged  on  to  the  WYLBUR  system,  there  are  four 
basic  commands  you  will  need  to  use: 

•  LOG  (locate)  will  list  the  files  on  your  account. 

•  FETCH  command  will  place  a  copy  of  a  file  in  your 
local  file  space  where  you  can  manipulate  and  view 
it.  ITiere  can  be  only  one  file  in  the  local  space  at  any 
given  time,  so  if  you  wish  to  view  more  than  one  file 
during  a  session,  the  local  file  space  must  be  cleared. 
The  system  will  supply  the  prompt  “OK  TO 
CLEAR?”  if  you  use  the  FETCH  command  when  the 
local  file  space  is  not  empty.  Respond  by  entering 
“OK”.  This  does  not  affect  the  permanent  copy  of  the 
file  that  was  in  the  local  file  space. 

•  PURGE  deletes  a  permanent  file.  Biter  PURGE  and 
the  associated  job  number  to  identify  the  file  you  wish 
to  delete. 

•  LIST  command  (explained  in  greater  detail  in  ‘"Using 
the  LIST  command  on  the  WYLBUR  system”). 

For  more  information  on  WTLBUR  commands,  enter  H 
HELP  at  the  “COMMAND?”  prompt. 


To  retrieve  your  output,  follow  the  steps  outlined  in 
“Logging  on  to  the  USGS  Amdahl  computer”  and  then 
enter  to  log  on  to  WYLBUR. 

to  tJVS  WYLBUR  7.0  TERMtSAt  'rERM43 
OBER  XD?  on  this  document Atilon) 

KEVWORDt  PKSSWOSL 
ACcetKo  IS  EEFECT; 

************************  ******  A  ********  * 

EUtER  NEWS"'  FOR  SYSTEM  BULLETINS 

********************************************* 

ABCD123.LIB  NOT  ON  CATLG 
EXEC  BREAK 

To  locate  your  job  in  the  WYLBUR  Fetch  Queue,  enter 
the  LOC  command  and  look  for  the  job's  4-digit  job 
number.  Also  notice  the  job  name  character  appended  to 
the  end  of  your  user  ID. 

LOC 

■JOB  4133  ABCD123A  AW  FETCH 

Job  4133  is  present  in  the  WYLBUR  fetch  queue.  Use 
fetch  to  get  it.  The  job  number  was  assigned  when  the  job 
was  submitted  for  processing  (4133  here). 

COWdAWD?  flTCat 

To  list  it  on  the  terminal  screen  use  the  L  command.  See 
“Using  the  LIST  command  on  the  WYLBUR  system”  for 
more  information. 

CCaaiAND^  L  1/10  •  '  _ 

This  command  will  display  the  first  10  lines,  which 
contain  some  job  diagnostics  messages.  By  viewing  the 
first  10-15  lines,  it  should  be  apparent  whether  or  not  the 
job  was  successful.  The  size  of  the  file  can  also  be  an 
indication  if  you  have  an  idea  of  how  much  information 
should  have  been  retrieved  by  the  job. 

Before  the  actual  WATSTORE  processing  information 
and  data,  there  are  200-400  lines  of  job  diagnostics  and 
cost  information.  The  series  of  commands  that  follow 
will  download  the  relevant  information  and  data. 

List  all  lines  containing  “PROGRAM”  beginning  in 
column  1  by  entering: 

:::  C(»&1AND?  L  "PROmM"  1 


Note:  When  working  with  the  WATSTORE  message 
file,  enter  L  ‘DAILY  VALUES’  instead  of  L 
‘PROGRAM’  1. 


Set  your  microcomputer  to  receive  and  store  the 
information  using  your  communications  software 
package.  Be  certain  that  there  is  enough  space  avail¬ 
able  on  the  disk  to  which  you  direct  the  file.  If  the  disk 
fills  to  capacity  during  the  transfer,  there  is  no  easy  way 
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to  locate  the  point  in  the  output  file  where  the  transfer 
ended,  and  you  may  be  forced  to  download  all  the  infor¬ 
mation  again.  If  the  information  to  be  received  is  exten¬ 
sive,  it  is  recommended  that  an  empty  formatted  diskette 
be  placed  in  another  disk  drive  and  the  file  downloaded 
to  it  or  to  a  hard  disk.  (A  hard  disk  is  faster  when 
receiving  data.) 

List  the  WATSTORE  processing  information  and  data 
without  line  numbers  with  the  following  command.  (Re¬ 
place  the  “x’’  with  the  line  number  displayed  by  the  L 
‘PROGRAM’  1  command.) 

L  x/LAST  UNN 

The  data  transfer  is  complete  when  the  ‘XUOMMAND?” 
prompt  is  displayed.  Terminate  the  receiving  process. 

If  you  are  through  with  this  file  on  the  Amdahl,  purge  it. 

PURGE  (job  number) 

When  you  are  finished,  log  off. 

COMMAND?  LOGOFF 

OK  TO  CLEAR?  OK 

The  WATSTORE  streamfiow  data  should  now  be  stored 
on  your  microcomputer. 


Using  the  “LIST”  Command  on  the 
WYLBUR  System 

The  list  command  can  be  used  to  locate  key  words  or 
phrases,  determine  the  length  of  the  output  file  and  display 
the  contents.  The  syntax  of  the  list  command  is: 

L  <range>  [<list  options>] 
range — 

Symbolic  line  numbers  that  may  be  used  in  the  range  are 

FIRST  LAST  END  PREVIOUS  CURRENT  or* 
NEXT 

Explicit  range: 

X — A  single  line  number  x. 
x/y — Line  number  x  through  line  number  y. 
x(z) — z  number  of  lines  beginning  at  x. 

Associative  range: 

[-]  [‘string’]  [miyn]] 

where 

-  Means  that  the  string  condition  has  been 
satisfied  if  the  line  does  NOT  contain  the 
string  within  the  columns  searched. 


‘string’  May  consist  of  alphabetic  or  numeric  char¬ 
acters,  special  characters,  and  blanks.  The 
null  string  is  also  allowed.  The  string  condi¬ 
tion  has  been  satisfied  when  a  line  contains 
‘string’  in  the  columns  searched, 
m/n  Restricts  the  search  for  ‘string’  to  columns  m 
through  n  in  a  given  line.  If  only  m  is  speci¬ 
fied,  ‘string’  must  begin  in  that  column.  If  m 
and  n  are  omitted,  the  entire  line  (columns  1 
through  133)  is  searched.  When  the  null 
string  is  specified,  m/n  must  be  omitted. 

LIST  options: 

[LIST  NOLIST]  [TEXT  NOTEXT]  [NUMBERED 
UNNUMBERED  NONUMBER  INTE¬ 

GER] 


LIST 

Causes  line  to  be  listed. 

NOLIST 

Prevents  lines  from  being  listed. 

TEXT 

Causes  the  text  of  the  lines  to  be 
listed,  but  not  the  line  numbers. 

NOTEXT 

Causes  line  numbers  to  be  listed,  but 
no  text  of  the  lines. 

NUMBERED 

Causes  the  text  and  the  line  numbers 
to  be  listed. 

UNNUMBERED 

Causes  the  text  of  the  line,  but  no  line 
number  to  be  listed. 

NONUMBER 

Causes  the  text  of  lines  that  have 
blanks  for  line  numbers  to  be  listed. 

INTEGER 

Causes  the  text  of  lines  to  be  listed. 
The  line  number  is  listed  as  an  8-digit 
integer. 

For  additional  information  on  this  command  and  other 
WYLBUR  commands  enter  H  HELP  at  the  “COM¬ 
MAND”  prompt. 

Use  the  following  variation  of  the  list  command  to  locate 
and  display  specific  sections  of  the  output  file.  Should  you 
accidentally  submit  a  command  that  you  wish  to  terminate, 
press  Qrl-End  to  send  a  break  sequence  to  the  mainframe. 
Then,  you  will  be  supplied  with  the  “COMMAND?” 
prompt  again. 

L  1/10  UNN  Lists  line  1  through  10  without  line 
numbers. 

L  LAST  Lists  the  last  line  of  the  file  and  its  line 
number. 
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L  ‘PRO-  Lists  all  lines  containing  ‘TRO- 
GRAM‘  1  GRAM”  beginning  in  column  1  with 
line  numbers. 

L  x/LAST  UNN  Lists  lines  from  line  number  x 
through  the  end  of  the  file  without 
line  numbers  being  displayed. 

Step  6:  Verifying  Data  Retrieved  from  the  WYLBUR 
System 

For  verification  purposes,  you  may  wish  to  download  the 
WATSTORE  data  twice,  each  to  an  individual  file,  and 
then  run  a  file  comparison  utility.  If  errors  occured  during 
the  retrieval,  the  chance  that  an  error  would  occur  in  the 
same  position  in  both  transfers  is  very  remote. 


Note:  This  step  is  optional,  as  the  cost  of  downloading 
files  can  be  very  expensive  and  you  may  be 
limited  for  disk  space. 


The  file  comparison  utility  described  here  is  the  DOS 
utility,  FC.  The  syntax  for  FC  is  as  follows: 

FC/Nflf2 

where 

f  1  *  name  of  the  first  file,  and 
f2  =  name  of  the  second  file. 

The  N  option  shows  the  line  numbers  so  that  the  posi¬ 
tions  within  the  file  can  be  found. 

Before  the  file  comparison  utility  is  executed,  the  com¬ 
puter  should  be  set  to  print  all  that  is  displayed  on  the 
screen.  To  initiate  this,  press  Ctrl-P.  To  terminate  printing, 
press  Ctrl-P  a  seccmd  time. 


Step  7:  Preparing  Retrieved  Information  for  Use 

There  is  limited  editing  necessary  before  the  data  is 
printed  for  reference  or  publication.  Any  ASCII  editor  may 
be  used.  The  WATSTORE  processing  information  pre¬ 
cedes  the  data,  both  printed  and  punched.  In  most  cases, 
you  will  want  to  remove  this  portion  of  the  output.  This 
information  is  important  for  verification  of  the  parameters 
and  controls  used  in  the  retrieval,  in  addition  to  messages 
such  as  invalid  station  numbers  and  dates.  At  the  end  of 
the  retrieved  file,  there  may  be  lines  that  should  be  re¬ 
moved.  The  line(s)  to  remove  include  the  line  containing 
“COMMAND?”  through  the  end  of  the  file. 

Before  printing  files  retrieved  from  WATSTORE  using 
the  DAILY,  INVENT^  or  PEAK  programs,  the  files  could 
be  processed  by  the  PAGEBR  program  to  insert  printer 
control  characters  at  the  points  where  printing  should 
begin  on  a  new  page.  The  page  breaks  are  determined  by 
key  phrases  in  specific  positions,  called  headers.  In  the 
absence  of  a  header,  a  control  character  is  inserted  every 
60  lines. 

A  summary  of  the  previous  preparation  process  follows: 

1.  Examine  the  WATSTORE  processing  information  at 
the  top  of  the  file  and  remove  (if  needed  or  desired) 
with  an  editor. 

2.  Remove  line(s)  from  the  end  of  the  file — alines  con¬ 
taining  ‘GOMMAND?”  through  the  end  of  the  file. 

3.  Execute  the  PAGEBR  program  to  insert  printer  con¬ 
trol  characters  for  page  breaks. 

4.  Set  the  printer  at  a  page  break. 

5.  Set  print  font  to  17  characters  per  inch. 

6.  Print  file  by  entering: 

PRINT  filename  or  COPY  filename  PRN 
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Acre-foot  That  volume  of  water  required  to  cover  1  acre  of  land  to  a  depth  of  1  foot,  equal  to  43,560  cubic  feet  or 
1233.49  cubic  meters. 

Age  Class  A  cohort  of  organisms,  all  the  same  age,  bom  within  the  same  year.  In  fisheries,  an  age  group  is  often 
referred  to  as  Age  0, 1,  H,  HI,  etc.  See  Year  Class. 

Annual  Flow  The  total  volume  of  water  passing  a  given  point  in  one  year.  May  be  expressed  as  a  volume  (e.g., 
acre-feet)  but  may  also  be  expressed  as  an  equivalent  constant  discharge  over  the  year,  such  as  cfs. 

Annual  Yield  Annual  flow  per  unit  area,  as  cfsm  (see  CFSM). 

Annual  Habitat  Index  A  single  habitat  value  you  have  chosen  to  be  representative  of  the  annual  habitat  for  a  given 

species  or  life  stage.  Very  often  it  is  the  minimum  habitat  value  encountered  when  time  series  analysis  is  used  to 
approximate  population  bottlenecks;  may  be  the  maximum,  average,  or  some  other  measure  of  habitat  value. 

Area,  Drainage  The  surface  area  tributary  to  a  lake  or  stream.  Sometimes  called  catchment  area,  watershed  area, 
or  river  basin  area;  we  prefer  drainage  area,  which  is  less  geographic  and  has  specific  units  (square  miles)  suitable 
for  our  purposes. 

Area,  Usable  The  area  under  the  wetted  surface  of  a  stream  that  can  be  used  by  aquatic  organisms.  Units:  square 
feet  or  square  meters,  usually  per  specified  length  of  stream. 

Area,  Weighted  Usable  (WUA)  The  wetted  area  of  a  stream  weighted  by  its  suitability  for  use  by  aquatic  organisms 

or  recreational  activity.  Units:  square  feet  or  square  meters,  usually  per  specified  length  of  stream. 

ASCn  Acronym  for  American  Standard  Code  for  Information  Interchange.  The  coding  scheme  was  developed  by 
the  American  National  Standards  Institute  to  ensure  compatibility  between  various  data  processing  software  and 
communications  equipment.  We  use  ASCII  to  be  distinct  from  any  special  word  processing  data  format. 

Baseflow  The  sustained  low  flow  of  a  stream,  usually  considered  to  be  groundwater  inflow  to  the  stream  channel. 

Baseline  The  conditions  occurring  during  the  reference  time  frame,  usually  referring  to  water  supply,  habitat  values, 

or  population  status.  Baseline  is  often  some  actual  recent  historical  period  but  may  also  represent  (1)  the  same 
climatological-meteorological  conditions  but  with  present  water  development  activities  on  line,  (2)  the  same 
climatological^eteorological  conditions  but  with  both  current  and  proposed  future  development  on  line,  or  (3)  virgin 
or  pre-development  conditions.  The  definition  of  baseline  will  always  depend  on  the  objectives  of  the  study.  Quite 
often,  two  or  more  baseline  conditions  may  be  necessary  to  evaluate  a  specific  project. 

Batch  File  A  group  of  operating  system  commands  that  enable  multiple  tasks  to  be  performed.  Often  called  a 
Procedure  file  on  the  CDC  Cyber  computers. 

Biological  (or  Fish)  Year  Variously  defined.  Often  used  beginning  with  egg  deposition  but  may  be  defined  as  the 
logical  start  of  any  given  life  stage  or  phenological  relation.  In  the  effective  habitat  calculations  in  TSLIB,  the 
biological  year  is  the  time  of  egg  hatch  or  emergence. 

Calendar  Year  1  Januaiy  through  31  December  (see  Climatological  Year,  Pbwer  Year,  and  Water  Year). 
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Capacity,  Carrying  The  maximum  number  (or  weight)  of  an  organism  that  can  be  maintained  during  that  period 
of  least  available  habitat  under  a  dynamic  flow  regime.  Carrying  capacity  should  be  considered  a  mean  value  for  a 
specified,  short  interval  (e.g.,  1  day,  1  week,  1  month)  around  which  populations  may  fluctuate. 

CFS  One  cubic  foot  per  second. 

CFSM  One  cubic  foot  per  second  per  square  mile  of  drainage  area. 

Climatological  Year  1  April  through  3 1  March;  used  to  represent  that  period  from  the  start  of  one  growing  season 
to  another. 

CMS  One  cubic  meter  per  second. 

Coefficient  of  Variation  CV;  the  ratio  of  the  sample  standard  deviation  to  the  sample  mean. 

Cohort  That  group  of  individuals  bom  within  a  relatively  short  period. 

Composite  In  the  current  edition  of  TSLIB,  composite  refers  to  the  simple  average  of  the  minimum  and  the 
maximum  habitat  value  for  a  specified  portion  of  the  year,  based  on  either  monthly  or  daily  values. 

Cross  Section  A  transect,  across  a  stream  channel,  that  is  perpendicular  to  the  direction  of  flow. 

CUSEC  Another  way  of  saying  cubic  foot  per  second;  not  currently  in  common  use. 

Curves,  Preference  See  Suitability  Curves. 

Curves,  Suitability-of-Use  SI;  see  Suitability  Curves. 

Curves,  Usability  See  Suitability  Curves. 

Default  A  selection  made  by  a  computer  program  or  procedure  file  if  the  user  does  not  explicitly  choose  an 
alternative. 

Discharge  The  rate  of  flow,  or  volume  of  water  flowing,  in  a  given  stream  at  a  given  place  and  within  a  given 
period,  usually  expressed  as  cfs  or  cms. 

Discharge,  Bankful  Discharge  corresponding  to  the  stage  at  which  the  overflow  plain  begins  to  be  flooded. 

Drought  A  prolonged  period  of  less-than-average  water  availability. 

Dry  Season  That  period  of  a  year  that  is  characteristically  dry  (and  has  the  lowest  streamflow),  implying  an  annual 

seasonal  cycle. 

Dry  Year  (or  Dry  Month)  A  period  with  a  given  probability  of  representing  dry  conditions;  for  example,  a  given 
year  or  month  may  be  as  dry  or  drier  than  80%  of  all  other  similar  periods. 

Duration  (1)  The  percentage  of  time  a  class  of  events  occur.  (2)  An  event’s  time  span. 

Duration  Analysis  Examination  of  a  certain  period  of  record  to  categorize  the  frequency  of  classes  of  events  within 

that  period. 
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Effective  Habitat  That  portion  of  available  physical  habitat  actually  occupied  by  a  life  stage  due  to  mortality  (or 
other  constraint)  of  previous  life  stages.  Effective  habitat  analysis  implies  following  cohorts  of  habitat  use  through 
time,  as  a  population-limiting  habitat  event  may  not  become  manifest  until  some  later  date. 

Equivalent  Habitat  A  measure  of  one  life  stage’s  habitat  value  in  units  of  another  life  stage.  A  common  practice 
is  to  convert  all  life  stages’  habitat  values  to  adult  equivalent  values — that  way,  one  can  assess  which  life  stage  is  the 
most  limiting  at  any  single  time  (compare  with  Effective  Habitat).  Requires  a  method  for  determining  the  ratio  of 
one  life  stage’s  habitat  value  for  that  of  another. 

Evolutionary  Time  Series  A  time  series  with  trends;  compare  with  Stationary  Time  Series. 

Exceedence  That  probability  of  an  event  exceeding  others  in  a  similar  class.  Note  that  this  may  be  “equal  or  exceed’* 

or  “exceed”  only.  Occasionally,  probabilities  may  be  expressed  as  nonexceedence — that  is,  the  probability  of  being 
“less  than  or  equal”  or  just  “less  than.” 

Firm  Yield  That  value  of  flow,  power,  or  habitat  that  could  be  maintained  year  after  year,  almost  regardless  of  the 

circumstances — for  example,  a  reservoir’s  firm  yield  might  be  that  amount  of  water  that  could  be  delivered  to  meet 
the  demand  95%  of  the  time  for  a  specified  planning  horizon  (e.g.,  5  years). 

Fish  Year  See  Biological  Year. 

Flood  Any  flow  which  exceeds  the  bankful  capacity  of  a  stream  or  channel  and  flows  out  on  the  floodplain. 

Flow  The  movement  of  a  stream  of  water  or  other  mobile  substances  from  place  to  place;  discharge;  total  quantity 
carried  by  a  stream. 

Flow,  Augmented  Any  flow  modified  to  be  greater  than  it  would  be  under  natural  conditions. 

Flow,  Enhancement  A  flow  regime  that  is  better  (in  quantity  or  quality)  than  the  baseline  regime  for  fish,  wildlife, 
water  quality,  or  recreation. 

Flow,  Flushing  That  flow  of  sufficient  magnitude  and  duration  capable  of  removing  fines  from  the  interstitial  spaces 

among  the  stream  bottom  gravel  and  maintains  intergravel  permeability. 

Flow,  Natural  The  flow  regime  of  a  stream  as  it  would  occur  under  completely  unregulated  conditions — that  is, 
not  subjected  to  regulation  by  reservoirs,  diversions,  or  other  human  works. 

Flow,  Regulated  Modified  natural  flow  to  achieve  a  specified  purpose  or  objective. 

Flow,  Steady  and  Unsteady  Flow  in  an  open  channel  is  said  to  be  steady  if  the  depth  of  flow  does  not  change  or 
can  be  assumed  constant  over  a  specified  interval;  the  flow  is  unsteady  if  the  depth  changes  with  time. 

Function  Key  A  key  on  an  IBM-PC  (or  compatible  microcomputer)  labeled  FI  to  FIO  (or  F12)  that  enables  certain 

tasks  within  the  RPM  and  RTSM  software. 

Gage,  Stream  A  device  for  measiuing  the  magnitude  of  discharge  in  a  stream  at  a  specific  location. 

HABEF  Program  A  PHABSIM  program  that  calculates  the  physical  habitat  considering  the  conditions  at  two 
streamflows  or  for  two  life  stages  or  species  of  fish. 

Habitat  The  place  where  a  population  lives  and  its  surroundings,  both  living  and  nonliving;  includes  life  require¬ 
ments  such  as  food  and  shelter  (see  Physical  Habitat). 


246 


BIOLCK5ICAL  Report  90  (16) 


Habitat  Ratio  The  amount  of  adult  habitat  that  can  be  used  at  a  particular  time,  given  the  amount  of  subadult  habitat 

fully  used  in  previous  years  or  months. 

Hydrodata  A  data  base  of  hydrologic  information  published  on  compact  disk  by  Earthinfo  in  Boulder,  Colorado. 

Hydrograph  A  graph  showing  the  variation  in  stage  (depth)  or  discharge  over  a  specified  time. 

Hydropeaking  The  practice  of  abruptly  alternating  between  a  low  base  and  a  high  peak  flow,  typically  for  on-peak 

electrical  power  generation;  compare  with  hydropulsing,  in  which  flows  may  also  range  from  low  to  high  but  are 
gradually  varied  over  a  longer  period. 

Incremental  Method  The  process  of  developing  an  instream  flow  policy  that  incorporates  multiple  or  variable 
rules  to  establish,  through  negotiation,  flow  window  requirements  or  guidelines  to  meet  the  needs  of  an  aquatic 
ecosystem,  given  water  supply  or  other  constraints.  Usually  implies  the  determination  of  a  habitat-discharge  relation 
for  the  purpose  of  comparing  streamflow  alternatives  through  time  (see  Standard  Setting). 

Index-A  The  average  of  the  values  in  a  time  series  for  events  between  50  and  90%  exceedence. 

Index-B  The  average  of  the  values  in  a  time  series  for  events  between  10  and  90%  exceedence. 

Index-C  The  average  of  the  values  in  a  time  series  for  events  between  user-specified  exceedence  levels. 

Instantaneous  (Peak)  Flow  The  single  largest  flow  measured  instantaneously  and  not  averaged  over  a  longer  time, 

such  as  a  day  or  month. 

Life  Stage  An  arbitrary  age  classification  of  an  organism  into  categories  related  to  body  morphology  and 
reproductive  potential,  such  as  spawning,  egg  incubation,  larva  or  fry,  juvenile,  and  adult  (see  Cohort). 

Low  Exceedence  See  Exceedence. 

Macrohabitat  Abiotic  habitat  conditions  in  a  segment  of  river  controlling  longitudinal  distribution  of  aquatic 
organisms,  usually  describing  channel  morphology,  flow,  or  chemical  properties  or  characteristics  with  respect  to 
suitability  for  use  by  organisms. 

Mean  Daily  Flow  (1)  The  discharge  volume  passing  a  given  point  averaged  over  1  day.  (2)  The  average  flow  for 
1  day  computed  from  several  years’  worth  of  data  for  that  day.  Usually  expressed  as  cfs  or  cms. 

Mean  Monthly  Flow  (1)  The  discharge  volume  passing  a  given  point  averaged  over  1  calendar  month.  (2)  The 
average  flow  for  1  month  computed  from  several  years’  worth  of  data  for  that  month.  Usually  expressed  as  cfs  or 
cms. 


Median  Daily  Flow  That  discharge  at  a  given  point  for  which  there  are  equal  numbers  of  greater  and  lesser  flow 
occurrences  during  1  day. 

Median  Monthly  Flow  That  discharge  at  a  given  poii  for  which  there  are  equal  numbers  of  greater  and  lesser 
flow  occurrences  during  1  month. 

Microhabitat  Small,  localized  areas  within  a  broader  habitat  type  used  by  organisms  for  specific  purposes  or  events, 

typically  described  by  a  combination  of  depth,  velocity,  substrate  or  cover. 

Operation  Rule  Criteria  by  which  managers  of  water  projects  determine  when  and  how  much  water  to  store,  release, 

or  divert. 
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Periodicity  That  pattern  or  timing  during  a  biological  year  when  a  given  organism  or  life  stage  is  active  or  present 
in  the  system  under  study. 

Persistence  A  nonrandom  process  within  a  time  series  of  hydrological  or  meteorological  events  that  tend  to  have 
high  events  following  other  highs  and  low  events  following  other  lows. 

PHABSIM  (pronoimced  P-HAB-SIM)  The  Physical  HABitat  SIMulation  system;  a  set  of  software  and  methods 
that  allows  the  computation  of  a  relation  between  streamflow  and  physical  habitat  for  various  life  stages  of  an  aquatic 
organism  or  a  recreational  activity. 

Plotting  Point  Variously  defined;  usually  computed  as  the  rank  order  (m)  divided  by  the  number  of  elements  plus 
one  {N  +  1),  resulting  in  the  exceedence  value.  Note  that  defined  this  way,  no  event  will  ever  have  a  zero  or  one 
exceedence  value,  which  is  appropriate  for  any  sample  of  data. 

Physical  Habitat  Those  abiotic  factors  (such  as  depth,  velocity,  substrate,  cover,  temperature,  water  quality)  that 
make  up  a  portion  of  an  organisms  living  space  (see  Habitat). 

Power  Year  Variously  defined;  usually  begins  with  the  month  of  the  least  energy  demand. 

Preference  Curves  See  Suitability  Curves. 

Procedure  File  See  Batch  File. 

QT-IO  The  lowest  continuous  7-day  flow  with  a  10-year  recurrence  interval  (see  Seven  Day  Minimum). 

Reach  A  comparatively  short  length  of  a  stream,  channel,  or  shore.  One  or  more  reaches  compose  a  segment.  The 

actual  length  is  defined  by  the  purpose  of  the  study  but  is  usually  no  greater  than  5-7  times  the  channel  width. 

Reach  Length  The  length  of  a  section  or  piece  of  a  river. 

Recurrence  Interval  The  inverse  of  the  probability  that  a  certain  event  will  occur,  normally  expressed  in  years. 
For  example,  a  flow  with  a  recurrence  interval  of  10  years  would  be  expected  to  occur,  on  average,  once  every  10 
years. 

Regime  The  general  pattern  (magnitude  and  frequency)  of  flow  or  temperature  events  through  time  at  a  particular 
location,  (e.g.,  snowmelt  regime,  rainfall  regime). 

Rule  Curve  See  Operation  Rule. 

Scaling  A  technique  for  adjusting  flows  or  WUA  versus  flows  to  account  for  a  change  in  location  up  or  downstream 

from  a  point  of  known  value.  Scaling  is  usually  accomplished  by  the  drainage  area  ratio  technique  but  may  be 
accomplished  by  relative  stream  width  or  combinations  of  other  factors. 

Segment  Relatively  homogeneous  section  of  a  stream  composed  of  one  or  more  reaches  (homogeneity  almost 
always  refers  to  at  least  the  channel  morphology  and  discharge  within  that  segment).  Boundaries  are  placed  wherever 
the  stream  undergoes  a  significant  change  in  discharge,  channel  structure,  water  quality,  or  temperature,  usually  at 
tributaiy  confluences  and  at  major  diversions.  Usually  considerably  longer  than  10-14  times  the  channel  width. 

Segment  Length  The  length  (in  miles  or  kilometers)  of  a  reach  of  stream  for  which  relatively  homogeneous 
conditions  exist,  allowing  characterization  of  habitat  versus  flow  by  a  single  relation. 


7Q10  See  Q7-10, 
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Seven  Day  Minimum  The  lowest  consecutive  7-day  flow  (or  habitat)  occurring  during  a  year.  Can  also  be  expressed 

as  a  frequency;  for  example,  a  one  in  ten  year  seven  day  event. 

Shell  A  computer  program  that  acts  as  a  user-interface  to  one  or  more  other  programs;  for  example,  RPM  is  a  shell 
for  the  PHABSIM  and  RTSM  is  a  shell  for  TSLIB. 

Standard  Deviation  SD;  the  positive  square  root  of  the  variance. 

Standard  Setting  (1)  A  streamflow  policy  or  technique  that  uses  a  single,  fixed  rule  to  establMi  (minimum)  flow 
requirements  regardless  of  dynamic  aquatic  ecosystem  needs.  (2)  The  process  of  determining  minimum  flow 
requirements  for  a  water  project  or  water  right.  The  minimum  flow  may,  to  varying  degrees,  consider  generic 
ecosystem  needs  (see  Incremental  Method). 

Stationary  Time  Series  A  time  series  of  events  with  no  (or  minimal)  discemable  trends. 

Steady  flow  See  How,  Steady  and  Unsteady. 

Suitability  Curves  Collectively  refers  to  categories  one  to  four  suitability  index  (SI)  curves  (see  next  four  entries). 

Suitability  Curves — Category  One  or  Literature-based  The  first  category  of  curves,  based  on  available  specu¬ 

lative  information,  including  literature  sources  and  expert  opinions;  usually  concerns  a  species  response  to  or 
macrohabitat  variable. 

Suitability  Curves — Category  Two  or  Utilization  A  curve  based  on  frequency  analysis  of  fish  observations  in 
the  stream  environment. 

Suitability  Curves — Category  Three  or  Preference  A  utilization  curve  that  has  been  corrected  for  environmental 

bias;  for  example,  if  50%  of  fish  are  found  in  pools  over  1,0  m  deep,  but  only  10%  of  the  stream  has  these  pools,  the 
fish  are  actively  selecting  that  habitat  type. 

Suitability  Curves — Category  Four  or  Conditional  A  preference  curve  that  is  conditioned  (stratified)  by  cover, 

season,  or  some  other  subdivision. 

Synthetic  Hydrograph  A  flow  time  series  artificially  constructed  for  a  given  location  through  various  analytical 
techniques. 

Temperature-conditioned  Habitat  Total  available  wetted  area  computed  from  the  weighted  usable  microhabitat 
area  adjusted  for  the  relative  suitability  for  stream  temperature. 

Time  Series  A  record  of  events  (flow,  habitat,  or  other)  through  time;  usually  describes  those  events  for  a  regular 
averaging  interval  like  hours,  days,  weeks,  months,  or  years. 

Time  Series  Analysis  Analysis  of  the  pattern  (frequency,  duration,  magnitude,  and  timing)  of  time-varying  events. 

These  events  may  be  discharge,  habitat  areas,  stream  temperature,  population  factors,  economic  indicators,  power 
generation,  and  so  forth. 

Total  Habitat  Total  available  wetted  area  conditioned  by  both  micro-  and  macrohabitat  suitability  and  summed  for 
all  relevant  river  segments. 

Transect  See  Cross  Section. 

Trigger  A  specified  condition  that  indicates  when  to  change  from  one  set  of  operational  criteria  (operations  rules) 
to  another. 
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TSLIB  A  set  of  computer  programs  and  analytic  methods  useful  for  performing  time  series  analysis. 

Unsteady  Flow  See  Flow,  Steady  and  Unsteady. 

Usable  Area  See  Area,  Usable. 

UtUization  Curves  See  Suitability  Curves. 

Variance  The  mean  value  of  the  square  of  the  deviations  of  the  sample  values  from  their  mean. 

Variation  Ratio  The  ratio  of  the  50-90%  exceedence  value  (Q50/Q90),  which  should  be  >  1, 

Water  Year  1  October  through  30  September;  usually  considered  to  represent  the  annual  hydrologic  cycle  beginning 

with  that  period  of  consistently  low  flows. 

WATSTORE  A  data  base  of  hydrologic  information  maintained  by  the  USGS  on  a  mainframe  computer  in  Reston, 

Virginia. 

Weighted  Usable  Area  (WUA)  See  Area,  Weighted  Usable. 

Weighting  Factor  The  value  that  weights  a  surface  area  or  volume  regarding  its  suitability  as  habitat  for  a  species 
or  recreational  activity. 

Wet  Season  That  period  of  a  year  that  is  characteristically  wet  (and  having  the  greatest  streamflows),  implying  an 
annual  seasonal  cycle. 

Wet  Year  A  water  year  characterized  by  above  average  discharge.  Exact  measure  of  deviation  from  some  average, 
or  median,  value  depends  on  the  decision  setting. 

Year  Class  A  cohort  of  organisms  bom  within  a  specified  calendar  year  (e.g.,  the  1986  year  class;  see  Age  Class). 


NOTE:  The  mention  of  trade  names  does  not  constitute  endorsement  or  recommendation  for  use  by  the  Federal  Government. 
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in  America 

U.S.  DEPARTMENT  OF  THE  INTERIOR 
FISH  AND  WILDLIFE  SERVICE 


As  the  Nation's  principal  conservation  agency,  the  Department  of  the  interior  heis 
responsibility  for  most  of  our  nationaily  owned  public  lands  and  natural  resources. 
This  includes  fostering  the  wisest  use  of  our  land  and  water  resources,  protecting 
our  fish  £uid  wildlife,  and  providing  for  the  enjoyment  of  life  through  outdoor 
recreation.  The  Department  assesses  our  energy  and  mineral  resources  and  works 
to  assure  that  their  development  is  in  the  best  interests  of  all  our  people.  The 
Departmnet  also  has  a  major  responsibility  for  American  Indian  reservation 
communities  and  for  people  who  live  in  island  territories  under  U.  S.  administration. 


